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Document Overview 


This manual provides guidance on how to use the SCPI commands in programming to realize remote 
control of RIGOL MSO1000Z/DS1000Z series digital oscilloscope through the remote interface. 
MSO1000Z/DS1000Z can communicate with a PC through the USB or the LAN bus. 


Main Topics in this Manual: 


Chapter 1 Programming Overview 

This chapter introduces how to build the remote communication between MSO1000Z/DS1000Z series 
digital oscilloscope and the PC. It also introduces the remote control methods as well as the syntax, 
symbols, parameters and abbreviation rules of the SCPI commands. 


Chapter 2 Command System 
This chapter introduces the syntax, function, parameter and using instruction of each command. 


Chapter 3 Programming Demos 

This chapter lists some programming demos to illustrate how to use commands to realize the common 
functions of the oscilloscope in the development environments of Excel, Matlab, LabVIEW, Visual Basic 6.0 
and Visual C++ 6.0. 


Tip 
For the newest version of this manual, please download it from RIGOL official website (www.rigol.com). 


Format Conventions in this Manual: 


1. Key 
The function key at the front panel is denoted by the format of "Key Name (Bold) + Text Box" in the 
manual. For example, Utility, denotes the "Utility" key at the front panel. 


2. Menu 
The menu item is denoted by the format of "Menu Word (Bold) + Character Shading" in the manual. 
For example, System denotes the "System" item under |Utility). 


3. Operation Step 
The next step of the operation is denoted by an arrow ">" in the manual. For example, (Utility) > 
System denotes pressing Utility) at the front panel and then pressing System. 


Content Conventions in this Manual: 


MSO1000Z/DS1000Z series includes the following models. Unless otherwise noted, this manual takes 
MSO1104Z-S as an example to illustrate the command system of MSO1000Z/DS1000Z series. 


Number of Number of Number of 
Model Analog Bandwidth | Analog Signal Source Digital Channels 

Channels Channels 
MSO1104Z-S 100 MHz 4 2 16 
MSO1074Z-S 70 MHz 4 2 16 
MSO1104Z 100 MHz 4 -- 16 
MSO1074Z 70 MHz 4 -- 16 
DS1104Z-S Plus | 100 MHz 4 2 16/1! 
DS1074Z-S Plus | 70 MHz 4 2 16/1! 
DS1104Z Plus 100 MHz 4 -- 16! 
DS1074Z Plus 70 MHz 4 -- 16! 
DS1054Z 50 MHz 4 = = 


Note!#/; Need to be upgraded to MSO using the MSO upgrade option. 
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Chapter 1 Programming Overview 


This chapter introduces how to build the remote communication between MSO1000Z/DS1000Z series 
digital oscilloscope and the PC. It also introduces the remote control methods as well as the syntax, 
symbols, parameters and abbreviation rules of the SCPI commands. 

Main topics of this chapter: 

@ To Build Remote Communication 

@ Remote Control Methods 

@  SCPI Command Overview 
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To Build Remote Communication 


This oscilloscope can communicate with a PC through the USB or the LAN bus. This section introduces how 
to control the oscilloscope remotely through the USB interface using Ultra Sigma in details. 


Operation Steps: 


1. Install the Ultra Sigma common PC software 
Download the Ultra Sigma common PC software from RIGOL official website (www.rigol.com) and 
install it according to the instructions. 


2. Connect the instrument and PC and configure the interface parameters of the instrument 
MSO1000Z/DS1000Z can communicate with a PC through the USB or the LAN bus. This manual takes 
the USB interface as an example. 


(1) Connect the devices 
Connect the USB Device interface at the real panel of the oscilloscope and the USB Host interface 
of the PC using a USB cable. 


(2) Install the USB driver 
This oscilloscope is a USB-TMC device. After you connect the oscilloscope to the PC and turn both 
on for the first time (the oscilloscope is automatically configured to the USB interface; at the same 
time, make sure that |Utility) > IO Setting > USB Device is set to "Computer"), the Found 
New Hardware Wizard as shown in the figure below is displayed on the PC. Please install the 
"USB Test and Measurement Device (IVI)" driver following the directions in the wizard. The steps 


are as follows. 
Found New Hardware Wizard 


This wizard helps you install software for: 


USB Test and Measurement Device (IVI) 


° ) If your hardware came with an installation CD 
<> or floppy disk, insert it now. 


What do you want the wizard to do? 


O Install the sothuace mmended) 


ate automatically (Reco 
) Install from a list or specific location [Advanced 1 


Click Next to continue. 2 
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Found New Hardware Wizard 


Please choose your search and installation options. Sate 


Y 


O Search for the best driver in these locations. 


Use the check boxes below to limit or expand the default search, which includes local 
paths and removable media. The best driver found will be installed. 


Search removable media (flopp ROM 


Include this location in the searc 


3: MD\LAN sDCOM 
© Don't search. | will choose the driver to install. 3 


Choose this option to select the device driver from a list. Windows does not guarantee that 
the driver you choose will be the best match for your hardware. 


4 


Found New Hardware Wizard 


Select the device driver you want to install for this hardware. 


Select the manufacturer and model of your hardware device and then click Next. If you 
ee have a disk that contains the driver you want to install, click Have Disk. 


Show compatible hardware 


Model 5 
<a SB Test and Measurement Device (v1) > 


Tell me why driver signing is important 


ds This driver is not digitally signed! 6 


Found New Hardware Wizard 


Please wait while the wizard installs the software... Pate 


= USB Test and Measurement Device (IVI) 


By p 


Setting a system restore point and backing up old files in 
case your system needs to be restored in the future. 


Bac Next Cance 
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(3) 


(4 


—_ 


(5 


—_ 
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Hardware Update Wizard 


Completing the Hardware Update 
Wizard 


The wizard has finished installing the software for: 


— USB Test and Measurement Device (IVI) 


Click Finish to close the wizard. 7 


(i) 


Search for device resource 
Start up the Ultra Sigma and the software will automatically search for the instrument resources 
currently connected to the PC. You can also click FUSE TMC | to search for the resources. 


View the device resources 

The resources found will appear under the "RIGOL Online Resource" directory and the model 
number and USB interface information of the instrument will also be displayed. 

For example, MSO1104Z (USBO::0x1AB1::0x04CE::DS1ZD170800001::INSTR). 


Control the instrument remotely 

Right click the resource name "MSO1104Z (USBO::0x1AB1::0x04CE::DS1ZD170800001::INSTR)" 
and select "SCPI Panel Control" to turn on the remote command control panel through which you 
can send commands and read data. 


Remote Control Methods 


1. User-defined Programming 
Users can use SCPI (Standard Commands for Programmable Instruments) commands to program and 
control the oscilloscope. For details, refer to the introductions in "Chapter 3 Programming Demos". 


2. Send SCPI Commands via PC Software 
You can control the oscilloscope remotely by sending SCPI commands via PC software. Ultra Sigma 
provided by RIGOL is recommended. 
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SCPI Command Overview 


SCPI (Standard Commands for Programmable Instruments) is a standardized instrument programming 
language that is built upon the standard IEEE 488.1 and IEEE 488.2 and conforms to various standards 
(such as the floating point operation rule in IEEE 754 standard, ISO 646 7-bit coded character for 
information interchange (equivalent to ASCII programming)). The SCPI commands provide a hierarchical 
tree structure and consist of multiple subsystems. Each command subsystem consists of a root keyword 
and one or more sub-keywords. 


Syntax 

The command string usually starts with ":"; the keywords are separated by ":" and are followed by the 
parameter settings available; "?" is added at the end of the command string to indicate query; the 
command keywords and the first parameter are separated by space. 


For example, 

:ACQuire:TYPE <type> 

:ACQuire: TYPE? 

ACQuire is the root keyword of the command. TYPE is the second-level keyword. The command string starts 
with ":" which is also used to separate the multiple-level keywords. <type> represents the parameters 
available for setting. "?" represents query. The command keywords :ACQuire:TYPE and parameter <type> 
are separated by a space. 

"" is generally used for separating multiple parameters contained in the same command, for example, 
[:TRACe[<n>]]:DATA:VALue volatile, <points>,<data> 


Symbol Description 
The following symbols will not be sent with the commands. 


1. Braces {} 
The parameters enclosed in the braces are optional and are usually separated by the vertical bar "|". 
When using the command, one of the parameters must be selected. 


2. Vertical Bar | 
The vertical bar is used to separate multiple parameters and one of the parameters must be selected 
when using the command. 


3. Square Brackets [] 
The content in the square brackets can be omitted. 


4. Triangle Brackets <> 
The parameter enclosed in the triangle brackets must be replaced by an effective value. 


Parameter Type 


1. Bool 
The parameter could be ON, OFF, 1, or 0. For example, 
:MEASure:ADISplay <bool> 
:MEASure:ADISplay? 
Wherein, 
<bool> can be set to {{1]ON}|{0]OFF}}. 
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The query returns 1 or 0. 


2. Discrete 
The parameter could be any of the values listed. For example, 
:ACQuire: TYPE <type> 
:ACQuire: TYPE? 
Wherein, 
<type> can be set to NORMal|AVERages|PEAK|HRESolution. 
The query returns the abbreviations (NORM, AVER, PEAK, or HRES). 


3. Integer 
Unless otherwise noted, the parameter can be any integer (NR1 format) within the effective value 
range. Note that do not set the parameter to a decimal, otherwise errors will occur. For example, 
:DISPlay:GBRightness <brightness> 
:DISPlay:GBRightness? 
Wherein, 
<brightness> can be set to any integer between 0 and 100. 
The query returns an integer between 0 and 100. 


4. Real 
The parameter can be any real number within the effective value range and this command accepts 
decimal (NR2 format) and scientific notation (NR3 format) parameter input. For example, 
:TRIGger:TIMeout:TIMe <NR3> 
:TRIGger:TIMeout: TIMe? 
Wherein, 
<NR3> can be set to any real number between 1.6e-08 (namely 16ns) to 1e+01 (namely 10s). 
The query returns a real number in scientific notation. 


5. ASCII String 
The parameter should be the combinations of ASCII characters. 
For example, 
:SYSTem:OPTion:INSTall <license> 
Wherein, 
<license> can be set to PDPUY9N9SQTS9PQSWPLAETRD3UJHYA. 


Command Abbreviation 


All the commands are case-insensitive and you can use any of them. If abbreviation is used, all the capital 
letters in the command must be written completely. For example, 
:MEASure:ADISplay? can be abbreviated to :MEAS:ADIS?. 
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Chapter 2 Command System 


This chapter introduces the syntax, function, parameter, and using instruction of each MSO1000Z/DS1000Z 
command. 


Main topics of this chapter: 
:AUToscale 

:CLEar 

RUN 

:STOP 

:SINGle 

:TFORce 

:ACQuire Commands 
:CALibrate Commands 
:CHANnel<n> Commands 
:CURSor Commands 


:DECoder Commands 


:DISPlay Commands 

:ETABle Commands 

:FUNCtion Commands 
IEEE488.2 Common Commands 


:LA Commands 
:MATH Commands 
:MASK Commands 
:MEASure Commands 


:REFerence Commands 


[: SOURce[<n>]] Commands 
:STORage Commands 


:SYSTem Commands 


[:TRACe[<n>]] Commands 


:TIMebase Commands 


:TRIGger Commands 


eo*e*?r?rreree+HeeteeeHHHHHHH HHH HHH HH 


:WAVeform Commands 


Note: 
1. Unless otherwise noted, this manual takes MSO1104Z-S as an example to introduce the commands. 
2. Unless otherwise noted, the descriptions and commands related to the digital channels in this manual 


are only applicable to MSO1000Z and DS1000Z Plus with the MSO upgrade option. 

For parameter setting commands (for example, the time, frequency, and amplitude), the oscilloscope 
can only accept numbers and set the parameters using the default units; it cannot recognize the units 
sent with the parameters. For the default unit of each parameter, please refer to the description in each 
command in the following introductions. 


wW 
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:-AUToscale 
Syntax :AUToscale 
Description Enable the waveform auto setting function. The oscilloscope will automatically adjust the 
vertical scale, horizontal timebase, and trigger mode according to the input signal to 
realize optimum waveform display. This command is equivalent to pressing the AUTO key 
at the front panel. 

Explanation > Theoretically, waveform auto setting function requires that the frequency of sine is no 
lower than 41Hz; the duty cycle should be greater than 1% and the amplitude must 
be at least 20mVpp for square (the probe ratio is 1X). 

> When the pass/fail function is enabled (see the :MASK:ENABle command), if you sent 
this command, the oscilloscope will disable the pass/fail function firstly and then 
execute the waveform auto setting function. 
> When the waveform record function is enabled or during the playback of the 
recorded waveform, this command is invalid. 
:CLEar 
Syntax :CLEar 
Description Clear all the waveforms on the screen. If the oscilloscope is in the RUN state, waveform 
will still be displayed. This command is equivalent to pressing the |CLEAR| key at the front 
panel. 
Related :DISPlay:CLEar 
Command 
-RUN 
:-STOP 
Syntax :RUN 
:STOP 
Description The :RUN command starts the oscilloscope and the :STOP command stops the 
oscilloscope. These commands are equivalent to pressing the IRUN/STOP| key at the 
front panel. 
Explanation When the waveform record function is enabled or during the playback of the recorded 
waveform, these commands are invalid. 
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‘SINGle 


Syntax :SINGle 


Description 


RIGOL 


Set the oscilloscope to the single trigger mode. This command is equivalent to any of the 
following two operations: pressing the SINGLE key at the front panel and sending 
the :TRIGger:SWEep SINGle command. 


Explanation > 


In the single trigger mode, the oscilloscope triggers once when the trigger conditions 
are met and then stops. 


> When the waveform record function is enabled or during the playback of the 
recorded waveform, this command is invalid. 


Related :TFORce 
Commands “RUN 


:STOP 


:-TFORce 
Syntax :TFORce 


Description Generate a trigger signal forcefully. This command is only applicable to the normal and 


single trigger modes (see the :TRIGger:SWEep command) and is equivalent to pressing 
the [FORCE | key in the trigger control area at the front panel. 
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-ACQuire Commands 


The :ACQuire commands are used to set and query the memory depth, acquisition mode and the number of 
averages as well as query the current sample rate of the oscilloscope. 

Command List |"); 

@ :ACQuire:AVERages 

@ = :ACQuire:MDEPth 

@ :ACQuire: TYPE 

@ :ACQuire:SRATe? 


Note!4: In the "Command List" in this manual, the parameters in the setting commands and the query commands are 
not included and you can refer to the complete introductions of the commands in the text according to the keywords. 


:ACQuire:AVERages 
Syntax :ACQuire:AVERages <count> 
:ACQuire:AVERages? 


Description Set or query the number of averages under the average acquisition mode. 


Parameter Name Type Range Default 


<count> Integer | 2" (nis an integer from 1 to 10) 2 
Explanation > Youcan sent the :ACQuire: TYPE command to set the acquisition mode. 


> Inthe average acquisition mode, greater number of averages can lower the noise 
and increase the vertical resolution, but will also slow the response of the displayed 
waveform to the waveform changes. 


Return The query returns an integer between 2 and 1024. 
Format 


Example :ACQuire:AVERages 128 /*Set the number of averages to 128*/ 
:ACQuire:AVERages? /*The query returns 128*/ 


2-4 MSO1000Z/DS1000Z Programming Guide 


Chapter 2 Command System RIGOL 


:ACQuire:MDEPth 
Syntax :ACQuire:MDEPth <mdep> 
:ACQuire:MDEPth? 


Description Set or query the memory depth of the oscilloscope (namely the number of waveform 
points that can be stored in a single trigger sample). The default unit is pts (points). 


Parameter Name Type Range Default 


<mdep> Discrete | Refer to Explanation AUTO 


Explanation > 


For the analog channel: 

— When a single channel is enabled, the range of <mdep> is {AUTO|12000| 
120000] 1200000] 12000000|24000000}. 

— When dual channels are enabled, the range of <mdep> is {AUTO]6000|60000| 
600000|6000000| 12000000}. 

— When three/four channels are enabled, the range of <mdep> is {AUTO|3000]| 
30000]300000|3000000|6000000}. 


For the digital channel: 

— When 8 channels are enabled, the range of <mdep> is {AUTO] 12000] 120000] 
1200000] 12000000] 24000000}. 

— When 16 channels are enabled, the range of <mdep> is {AUTO|6000|60000| 
600000|6000000| 12000000}. 


The following equation describes the relationship among memory depth, sample 
rate, and waveform length: 

Memory Depth = Sample Rate x Waveform Length 
Wherein, the Waveform Length is the product of the horizontal timebase (set by 
the :TIMebase[:MAIN]:SCALe command) times the number of grids in the horizontal 
direction on the screen (12 for MSO1000Z/DS1000Z). 
When AUTO is selected, the oscilloscope will select the memory depth automatically 
according to the current sample rate. 


Return The query returns the actual number of points (integer) or AUTO. 


Format 


Example :ACQuire:MDEPth 12000 /*Set the memory depth to 12000pts*/ 
:ACQuire:MDEPth? /*The query returns 12000*/ 


Related :ACQuire:SRATe? 


Command 
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:ACQuire:TYPE 
Syntax :ACQuire:TYPE <type> 
:ACQuire: TYPE? 


Description Set or query the acquisition mode of the oscilloscope. 


Parameter Name Type Range Default 


<type> Discrete {NORMal|AVERages|PEAK|HRESolution} NORMal 


Explanation > 


NORMal: in this mode, the oscilloscope samples the signal at equal time interval to 
rebuild the waveform. For most of the waveforms, the best display effect can be 
obtained using this mode. 


AVERages: in this mode, the oscilloscope averages the waveforms from multiple 
samples to reduce the random noise of the input signal and improve the vertical 
resolution. The number of averages can be set by the: ACQuire: AVERages command. 
Greater number of averages can lower the noise and increase the vertical resolution, 
but will also slow the response of the displayed waveform to the waveform changes. 


PEAK (Peak Detect): in this mode, the oscilloscope acquires the maximum and 
minimum values of the signal within the sample interval to get the envelope of the 
signal or the narrow pulse of the signal that might be lost. In this mode, signal 
confusion can be prevented but the noise displayed would be larger. 


HRESolution (High Resolution): this mode uses a kind of ultra-sample technique to 
average the neighboring points of the sample waveform to reduce the random noise 
on the input signal and generate much smoother waveforms on the screen. This is 
generally used when the sample rate of the digital converter is higher than the 
storage rate of the acquisition memory. 


Return The query returns NORM, AVER, PEAK, or HRES. 


Format 


Example :ACQuire:TYPE AVERages /*Select the average acquisition mode*/ 
:ACQuire: TYPE? /*The query returns AVER*/ 
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:ACQuire:SRATe? 
Syntax :ACQuire:SRATe? 
Description Query the current sample rate. The default unit is Sa/s. 


Explanation > Sample rate is the sample frequency of the oscilloscope, namely the waveform points 
sampled per second. 


> The following equation describes the relationship among memory depth, sample 
rate, and waveform length: 
Memory Depth = Sample Rate x Waveform Length 
Wherein, the Memory Depth can be set using the :ACQuire:MDEPth command, and 
the Waveform Length is the product of the horizontal timebase (set by 
the :TIMebase[:MAIN]:SCALe command) times the number of the horizontal scales 
(12 for MSO1000Z/DS1000Z). 


Return The query returns the sample rate in scientific notation. 
Format 


Example :ACQuire:SRATe? /*The query returns 2.000000e+09*/ 
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:CALibrate Commands 


Command List: 
@ = :CALibrate:QUIT 
@ :CALibrate:STARt 


:CALibrate:QUIT 
Syntax :CALibrate:QUIT 
Description — Exit the self-calibration at any time. 


Related :CALibrate:STARt 
Command 


:CALibrate:STARt 
Syntax :CALibrate:STARt 
Description The oscilloscope starts to execute self-calibration. 


Explanation > _ The self-calibration operation can make the oscilloscope quickly reach its optimum 
working state to obtain the most accurate measurement values. 


> During the self-calibration, all the channels of the oscilloscope must be disconnected 
from the inputs. 


> The functions of most of the keys are disabled during the self-calibration. You can 
send the :CALibrate:QUIT command to quit the self-calibration. 
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:‘CHANnel<n> Commands 


RIGOL 


The :CHANnel<n> commands are used to set or query the vertical system parameters of the analog 


channels, such as the bandwidth limit, coupling, vertical scale, and vertical offset. 


Command List: 


:CHANnel<n>:BWLimit 


:CHANnel<n>:COUPIling 


:CHANnel<n>:DISPlay 
:CHANnel<n>:INVert 


:CHANnel<n>:OFFSet 


:CHANnel<n>:RANGe 
:CHANnel<n>:TCAL 
:CHANnel<n>:SCALe 


:CHANnel<n>:PROBe 


ee 6% OH OO 


:CHANnel<n>:UNITS 
:CHANnel<n>:VERNier 


:CHANnel<n>:BWLimit 
:CHANnel<n>:BWLimit <type> 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


:CHANnel<n>:BWLimit? 


Set or query the bandwidth limit parameter of the specified channel. 


Name Type Range Default 
<n> Discrete {1|2|3|4} 7 
<type> | Discrete {20M|OFF} OFF 


> OFF: disable the bandwidth limit and the high frequency components of the signal 
under test can pass the channel. 
20M: enable the bandwidth limit and the high frequency components of the signal 


under test that exceed 20 MHz are attenuated. 


> Enabling the bandwidth limit can reduce the noise, but can also attenuate the high 
frequency components. 


The query returns 20M or OFF. 


:CHANneli:BWLimit 20M 


:CHANnel1:BWLimit? 


/*Enable the 20MHz bandwidth limit*/ 
/*The query returns 20M*/ 
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:CHANnel<n>:COUPling 


Syntax 
Description 


Parameter 


Explanation 


Return 
Format 


Example 


:CHANnel<n>:COUPling <coupling> 


:CHANnel<n>:COUPling? 


Chapter 2 Command System 


Set or query the coupling mode of the specified channel. 


Name Type Range Default 
<n> Discrete {1|2]3|4} - 
<coupling> Discrete {AC|DC|GND} DC 


> AC: the DC components of the signal under test are blocked. 


> DC: the DC and AC components of the signal under test can both pass the channel. 
> GND: the DC and AC components of the signal under test are both blocked. 


The query returns AC, DC, 


:CHANnel1:COUPling AC 
:CHANnel1:COUPling? 


:CHANnel<n>:DISPlay 
:CHANnel<n>:DISPlay <bool> 


Syntax 


Description 


Parameter 


Return 
Format 


Example 


:CHANnel<n>:DISPlay? 


or GND. 


/*Select the AC coupling mode*/ 
/*The query returns AC*/ 


Enable or disable the specified channel or query the status of the specified channel. 


Name Type Range Default 
<n> Discrete {1|2]3|4} -- 
CH1: 1J]ON 
<bool> Bool {{1]ON}|{0|OFF}} CH? to Pan 0|OFF 


The query returns 1 or 0. 


:CHANneli:DISPlay ON 
:CHANnel1i:DISPlay? 


/*Enable CH1*/ 


/*The query returns 1*/ 
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‘CHANnel<n>:INVert 
Syntax :CHANnel<n>:INVert <bool> 
:CHANnel<n>:INVert? 


Description Enable or disable the waveform invert of the specified channel or query the status of the 
waveform invert of the specified channel. 


Parameter Name Type Range Default 
<n> Discrete | {1]2]3|4} == 
<bool> | Bool {{1]ON}|{0|OFF}} O|OFF 


Explanation When waveform invert is turned off, the waveform display is normal; when waveform 
invert is turned on, the waveform voltage values are inverted. 


Return The query returns 1 or 0. 


Format 
Example = :CHANnel1i:INVert ON /*Enable the waveform invert of CH1*/ 
:CHANneli:INVert? /*The query returns 1*/ 
:CHANnel<n>:OFFSet 


Syntax :CHANnel<n>:OFFSet <offset> 
:CHANnel<n>:OFFSet? 


Description Set or query the vertical offset of the specified channel. The default unit is V. 


Parameter Name Type Range Default 
<n> Discrete | {1]2|3|4} = 


Related to the current vertical scale and 
probe ratio 

When the probe ratio is 1X, 

vertical scale=500mV/div: -100V to +100V | OV (the probe 
vertical scale<500mV/div: -2V to +2V ratio is 10X) 
When the probe ratio is 10X, 

vertical scale>5V/div: -1000V to +1000V 
vertical scale<5V/div: -20V to +20V 


<offset> | Real 


Return The query returns the vertical offset in scientific notation. 
Format 


Example :CHANneli:OFFSet 0.01 /*Set the vertical offset of CH1 to 10mV*/ 
:CHANnel1:OFFSet? /*The query returns 1.000000e-02*/ 


MSO1000Z/DS1000Z Programming Guide 2-11 


RIGOL Chapter 2 Command System 


:‘CHANnel<n>:RANGe 


Syntax :CHANnel<n>:RANGe <range> 
:CHANnel<n>:RANGe? 


Description Set or query the vertical range of the specified channel. The default unit is V. 


Parameter Name Type Range Default 
<n> Discrete {1|2|3]4} = 
Related to the probe ratio 
<range> | Real When the probe ratio is 1X: 8mV to 80V ey me is 
ratio is 10X) 


When the probe ratio is 10X: 80mV to 800V 


Explanation This command indirectly modifies the vertical scale of the specified channel (Vertical Scale 
= Vertical Range/8). The vertical scale can be set by the :CHANnel<n>:SCALe command. 


Return The query returns the vertical range in scientific notation. 
Format 


Example :CHANneli:RANGe 8 /*Set the vertical range of CH1 to 8V*/ 
:CHANneli:RANGe? /*The query returns 8.000000e+00*/ 
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:‘CHANnel<n>:TCAL 
Syntax :CHANnel<n>:TCAL <val> 
:CHANnel<n>:TCAL? 


Description Set or query the delay calibration time of the specified channel to calibrate the zero offset 
of the corresponding channel. The default unit is s. 


Parameter Name Type Range Default 
<n> Discrete {1|2]3|4} a 
<val> Real -100ns to 100ns 0.00s 


Explanation <val> can only be set to the specific values in the specified step. If the parameter you 
sent is not one of the specific values, the parameter will be set to the nearest specific 
values automatically. The step varies with the horizontal timebase (set by 
the :TIMebase[:MAIN]:SCALe command), as shown in the table below. 


Horizontal Timebase __| Step of the Delay Calibration Time 
5ns 100ps 

10ns 200ps 

20ns 400ps 

50ns ins 

100ns 2ns 

200ns 4ns 

500ns 10ns 

lus to 10us 20ns 


Note: When the horizontal timebase is equal to or greater than 10us, the delay 
calibration time cannot be adjusted. 


Return The query returns the delay calibration time in scientific notation. 
Format 


Example = :CHANnel1i:TCAL 0.00000002 /*Set the delay calibration time to 20ns*/ 
:CHANneli:TCAL? /*The query returns 2.000000e-08*/ 
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‘CHANnel<n>:SCALe 


Syntax :CHANnel<n>:SCALe <scale> 
:CHANnel<n>:SCALe? 


Description Set or query the vertical scale of the specified channel. The default unit is V. 


Parameter Name | Type Range Default 
<n> Discrete | {1]2|3]4} -- 
Related to the current probe ratio 
Zepales | Real When the probe ratio is 1X: 1mV to 10V 1V (the probe 
When the probe ratio is 10X (default): 10mV to | ratio is 10X) 
100V 


Explanation > _ The range of the vertical scale is related to the current probe ratio (set by 
the :CHANnel<n>:PROBe command). 


> You can use the :CHANnel<n>:VERNier command to enable or disable the fine 
adjustment of the vertical scale. By default, the fine adjustment is off. At this point, 
you can only set the vertical scale in 1-2-5 step, namely 10mV, 20mV, 50mV, 
100mV, ..., 100V (the probe ratio is 10X). When the fine adjustment is on, you can 
further adjust the vertical scale within a relatively smaller range to improve the 
vertical resolution. If the amplitude of the input waveform is a little bit greater than 
the full scale under the current scale and the amplitude would be a little bit lower if 
the next scale is used, fine adjustment can be used to improve the display amplitude 
of the waveform to view the signal details. 


Return The query returns the vertical scale in scientific notation. 
Format 


Example :CHANneli:SCALe 1  /*Set the vertical scale of CH1 to 1V*/ 
:CHANneli:SCALe? /*The query returns 1.000000e+00*/ 


-CHANnel<n>:PROBe 
Syntax :CHANnel<n>:PROBe <atten> 
:CHANnel<n>:PROBe? 


Description Set or query the probe ratio of the specified channel. 


Parameter Name_ | Type Range Default 
<n> Discrete | {1]2]3|4} -- 


{0.01]0.02]0.05]0.1]0.2]0.5]1]2]5]10|20|50| 
100|200|500| 1000} 


Explanation > _ Setting the probe ratio refers to multiply the signal sampled with the specified ratio 
and then display the result (the actual amplitude of the signal will not be affected). 


<atten> | Discrete 10 


> Setting the probe ratio will affect the range of the vertical scale. 


Return The query returns the probe ratio in scientific notation. 
Format 


Example :CHANneli:PROBe 10 /*Set the probe ratio of CH1 to 10X*/ 
:CHANneli:PROBe? /*The query returns 1.000000e+01*/ 


Related :CHANnel<n>:SCALe 
Command 


2-14 MSO1000Z/DS1000Z Programming Guide 


Chapter 2 Command System RIGOL 


:CHANnel<n>:UNITs 
Syntax :CHANnel<n>:UNITs <units> 
:CHANnel<n>:UNITs? 


Description Set or query the amplitude display unit of the specified channel. 


Parameter Name Type Range Default 
<n> Discrete {1]2]3|4} == 
<units> | Discrete {VOLTage|WATT|AMPere| UNKNown} VOLTage 

Return The query returns VOLT, WATT, AMP, or UNKN. 
Format 
Example :CHANnel1:UNITs VOLTage /*Set the amplitude display unit of CH1 to V*/ 
:CHANnel1:UNITS? /*The query returns VOLT*/ 


:CHANnel<n>:VERNier 
Syntax :CHANnel<n>:VERNier <bool> 
:CHANnel<n>:VERNier? 


Description Enable or disable the fine adjustment of the vertical scale of the specified channel, or 
query the fine adjustment status of the vertical scale of the specified channel. 


Parameter Name Type Range Default 
<n> Discrete {1]2|3|4} - 
<bool> Bool {{1]ON}|{0|OFF}} 0|OFF 


Explanation By default, the fine adjustment is off. At this point, you can only set the vertical scale in 
1-2-5 step, namely 10mV, 20mV, 50mV, 100mV...100V (the probe ratio is 10X). When the 
fine adjustment is on, you can further adjust the vertical scale within a relatively smaller 
range to improve the vertical resolution. If the amplitude of the input waveform is a little 
bit greater than the full scale under the current scale and the amplitude would be a little 
bit lower if the next scale is used, fine adjustment can be used to improve the display 
amplitude of the waveform to view the signal details. 


Return The query returns 1 or 0. 


Format 
Example :CHANnel1:VERNier ON /*Enable the fine adjustment function of the vertical scale of 
CH1*/ 
:CHANneli:VERNier? /*The query returns 1*/ 
Related :CHANnel<n>:SCALe 
Command 
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-CURSor Commands 


The :CURSor commands are used to measure the X-axis value (such as time) and Y-axis value (Such as 
voltage) of the waveform displayed on the screen. 


Command List: 
@ :CURSor:MODE 


@ :CURSor:MANual 
@ :CURSor:TRACk 

@ :CURSor:AUTO 

@ :CURSor:XY 
-‘CURSor:MODE 


Syntax :CURSor:MODE <mode> 
:CURSor:MODE? 


Description Set or query the cursor measurement mode. 


Parameter Name Type Range Default 
<mode> Discrete {OFF|MANual| TRACk|AUTO|XY} OFF 


Explanation OFF: disable the cursor measurement function. 
MANual: enable the manual cursor measurement mode. 
TRACK: enable the track cursor measurement mode. 


AUTO: enable the auto cursor measurement mode. 


VV VV WV 


XY: enable the XY cursor measurement mode. This mode is valid only when the 
horizontal timebase mode is XY. 


Return The query returns OFF, MAN, TRAC, AUTO, or XY. 


Format 
Example :CURSor:MODE MANual /*Enable the manual cursor measurement mode*/ 
:CURSor:MODE? /*The query returns MAN*/ 
Related :CURSor:MANual 
Conimands :CURSor: TRACK 
:CURSor:XY 


:TIMebase:MODE 
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:CURSor:MANual 


Command List: 
:CURSor:MANual: TYPE 
:CURSor:MANual:SOURce 


:CURSor:MANual: TUNit 
:CURSor:MANual:VUNit 
:CURSor:MANual:AX 
:CURSor:MANual:BX 
:CURSor:MANual:AY 
:CURSor:MANual:BY 


:CURSor:MANual:BXValue 


:CURSor:MANual:AXValue 
:CURSor:MANual:AYValue? 


:CURSor:MANual:BYValue 


Si A 2 A A A 2 2 A 2 A 2 


:CURSor:MANual:XDELta? 
:CURSor:MANual:IXDELta 
:CURSor:MANual:YDELta? 


:CURSor:MANual: TYPE 


Parameter Name 


RIGOL 
? 
? 
, 
? 
Syntax :CURSor:MANual:TYPE <type> 
:CURSor:MANual: TYPE? 
Description Set or query the cursor type in manual cursor measurement mode. 
Type Range Default 
<type> Discrete {X|Y} X 


Explanation >  X: select the X type cursors. The X type cursors are a vertical solid line (cursor A) and 
a vertical dotted line (cursor B) and are usually used to measure the time 
parameters. 


> YY: select the Y type cursors. The Y type cursors are a horizontal solid line (cursor A) 
and a horizontal dotted line (cursor B) and are usually used to measure the voltage 
parameters. 


> When the channel source of manual cursor measurement is set to LA 
(:CURSor:MANual:SOURce), the cursor type cannot be set to Y. 


Return § The query returns X or Y. 


Format 


Example :CURSor:MANual:TYPE Y 
:CURSor:MANual: TYPE? 


/*select the Y type cursors*/ 
/*The query returns Y*/ 
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:CURSor:MANual:SOURce 


Syntax :CURSor:MANual:SOURce <source> 
:CURSor:MANual:SOURce? 
Description Set or query the channel source of the manual cursor measurement mode. 
Parameter Name Type Range Default 
: {CHANnel1|CHANnel2|CHANnel3 | 
<source> | Discrete CHANnel4|MATH|LA} CHANnel1 


Explanation 


> Only the channel that is enabled currently can be selected. 


> When LA is selected, the cursor type cannot be set to Y (:CURSor:MANual: TYPE). 


Return The query returns CHAN1, CHAN2, CHAN3, CHAN4, MATH, or LA. 
Format 
Example  :CURSor:MANual:SOURce CHANnel2 /*Set the channel source to CH2*/ 


:CURSor:MANual:SOURce? /*The query returns CHAN2*/ 


:CURSor:MANual:TUNit 


Syntax :CURSor:MANual:TUNit <unit> 
:CURSor:MANual:TUNit? 
Description Set or query the horizontal unit in the manual cursor measurement mode. 
Parameter Name Type Range Default 
<unit> Discrete {S|HZ|DEGRee|PERCent} S 


Explanation 


>  S: AX, BX, and BX-AX in the measurement results are in "s" and 1/|dX| is in "Hz". 
> HZ: AX, BX, and BX-AX in the measurement results are in "Hz" and 1/|dX| is in "s". 
> DEGRee: AX, BX, and BX-AX are in "degree". 

> PERCent: AX, BX, and BX-AX are expressed in percentage. 


Return The query returns S, HZ, DEGR, or PERC. 
Format 
Example :CURSor:MANual:TUNit DEGRee /*Set the horizontal unit to "degree"*/ 


:CURSor:MANual:TUNit? /*The query returns DEGR*/ 
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:CURSor:MANual:VUNit 


Syntax 


Description 


Parameter 


Explanation 


RIGOL 
:CURSor:MANual:VUNit <unit> 
:CURSor:MANual:VUNit? 
Set or query the vertical unit in the manual cursor measurement mode. 
Name Type Range Default 
<unit> Discrete {PERCent|SOURce} SOURce 


> PERCent: AY, BY, and BY-AY in the measurement results are expressed in percentage. 


> SOURce: the units of AY, BY, and BY-AY in the measurement results will be 
automatically set to the unit of the current source. 


Return The query returns PERC or SOUR. 
Format 
Example :CURSor:MANual:VUNit PERCent /*Set the system to express AY, BY, and BY-AY in the 
measurement results in percentage*/ 
:CURSor:MANual:VUNit? /*The query returns PERC*/ 
Related :CHANnel<n>:UNITs 
Command 
:CURSor:MANual:AX 
Syntax :CURSor:MANual:AX <x> 
:CURSor:MANual:AX? 
Description Set or query the horizontal position of cursor A in the manual cursor measurement mode. 
Parameter Name Type Range Default 
<xX> Integer 5 to 594 100 


Explanation 


Return 
Format 


Example 


The horizontal and vertical positions of the cursor are defined by the pixel coordinate of 
the screen. The pixel coordinate of the screen ranges from (0,0) to (600,400). Wherein, 
(0,0) is located at the left top corner of the screen and (600,400) is located at the right 
bottom corner of the screen. The horizontal pixel range is from 0 to 600 and the vertical 
pixel range is from 0 to 400. 


The query returns an integer between 5 and 594. 


:CURSor:MANual:AX 200 
:CURSor:MANual:AX? 


/*Set the horizontal position of cursor A to 200*/ 
/*The query returns 200*/ 
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:CURSor:MANual:BX 


Syntax 


:CURSor:MANual:BX <x> 
:CURSor:MANual:BX? 


Description Set or query the horizontal position of cursor B in the manual cursor measurement mode. 
Parameter Name Type Range Default 
<x> Integer 5 to 594 500 
Explanation The horizontal and vertical positions of the cursor are defined by the pixel coordinate of 
the screen. The pixel coordinate of the screen ranges from (0,0) to (600,400). Wherein, 
(0,0) is located at the left top corner of the screen and (600,400) is located at the right 
bottom corner of the screen. The horizontal pixel range is from 0 to 600 and the vertical 
pixel range is from 0 to 400. 
Return The query returns an integer between 5 and 594. 
Format 
Example :CURSor:MANual:BX 200 /*Set the horizontal position of cursor B to 200*/ 
:CURSor:MANual:BX? /*The query returns 200*/ 
:CURSor:MANual:AY 
Syntax :CURSor:MANual:AY <y> 
:CURSor:MANual:AY? 
Description Set or query the vertical position of cursor A in the manual cursor measurement mode. 
Parameter Name Type Range Default 
<y> Integer 5 to 394 100 
Explanation > _ The horizontal and vertical positions of the cursor are defined by the pixel coordinate 
of the screen. The pixel coordinate of the screen ranges from (0,0) to (600,400). 
Wherein, (0,0) is located at the left top corner of the screen and (600,400) is located 
at the right bottom corner of the screen. The horizontal pixel range is from 0 to 600 
and the vertical pixel range is from 0 to 400. 
> When the signal source of manual cursor measurement is LA, Y type cursor is not 
required. 
Return The query returns an integer between 5 and 394. 
Format 
Example :CURSor:MANual:AY 200 /*Set the vertical position of cursor A to 200*/ 
:CURSor:MANual:AY? /*The query returns 200*/ 
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:CURSor:MANual:BY 
Syntax :CURSor:MANual:BY <y> 
:CURSor:MANual:BY? 
Description Set or query the vertical position of cursor B in the manual cursor measurement mode. 
Parameter Name Type Range Default 
<y> Integer 5 to 394 300 
Explanation > The horizontal and vertical positions of the cursor are defined by the pixel coordinate 
of the screen. The pixel coordinate of the screen ranges from (0,0) to (600,400). 
Wherein, (0,0) is located at the left top corner of the screen and (600,400) is located 
at the right bottom corner of the screen. The horizontal pixel range is from 0 to 600 
and the vertical pixel range is from 0 to 400. 
> When the signal source of manual cursor measurement is LA, Y type cursor is not 
required. 
Return The query returns an integer between 5 and 394. 
Format 
Example :CURSor:MANual:BY 200 /*Set the vertical position of cursor B to 200*/ 


:CURSor:MANual:BY? /*The query returns 200*/ 


:CURSor:MANual:AXValue? 


Syntax 
Description 


Return 
Format 


Example 


Related 
Commands 


:CURSor:MANual:AXValue? 


Query the X value of cursor A in the manual cursor measurement mode. The unit depends 
on the horizontal unit currently selected. 


The query returns the X value of cursor A in scientific notation. 


:CURSor:MANual:AXValue? 
:CURSor:MANual:AX 
:CURSor:MANual:TUNit 


/*The query returns -4.000000e-06*/ 


:CURSor:MANual:AYValue? 


Syntax 
Description 


Return 
Format 


Example 


Related 
Commands 


:CURSor:MANual:AYValue? 


Query the Y value of cursor A in the manual cursor measurement mode. The unit depends 
on the vertical unit currently selected. 


> When the signal source is CHANneli|CHANnel2| CHANnel3| CHANnel4|MATH, the 
query returns the Y value of cursor A in scientific notation. 


> When the signal source is LA, the query returns the decimal value corresponding to 
the sum of the binary weights of D15 bit to DO bit at cursor A (the value of the 
channel that is not turned on is 0 by default). 


:CURSor:MANual:AYValue? =/*The query returns 2.000000e+00*/ 


:CURSor:MANual:AY 
:CURSor:MANual:VUNit 
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:CURSor:MANual:BXValue? 


Syntax 


Description 


Return 
Format 


Example 


Related 
Commands 


:CURSor:MANual:BXValue? 


Query the X value of cursor B in the manual cursor measurement mode. The unit depends 
on the horizontal unit currently selected. 


The query returns the X value of cursor B in scientific notation. 


:CURSor:MANual:BXValue? 
:CURSor:MANual:BX 
:CURSor:MANual:TUNit 


/*The query returns 4.000000e-06*/ 


:CURSor:MANual:BYValue? 


Syntax 


Description 


Return 
Format 


Example 


Related 
Commands 


:CURSor:MANual:BYValue? 


Query the Y value of cursor B in the manual cursor measurement mode. The unit depends 
on the vertical unit currently selected. 


> When the signal source is CHANnel1|CHANnel2|CHANnel3|CHANnel4|MATH, the 
query returns the Y value of cursor B in scientific notation. 

> When the signal source is LA, the query returns the decimal value corresponding to 
the sum of the binary weights of D15 bit to DO bit at cursor B (the value of the 
channel that is not turned on is 0 by default) . 

:CURSor:MANual:BYValue? /*The query returns -2.000000e+00*/ 

:CURSor:MANual:BY 


:CURSor:MANual:VUNit 


:CURSor:MANual:XDELta? 


Syntax 


Description 


Return 
Format 


Example 


Related 
Commands 


:CURSor:MANual:XDELta? 


Query the difference between the X values of cursor A and cursor B (BX-AX) in the manual 
cursor measurement mode. The unit depends on the horizontal unit currently selected. 


The query returns the difference in scientific notation. 


:CURSor:MANual:XDELta? /*The query returns 8.000000e-06*/ 


:CURSor:MANual:AX 


:CURSor:MANual:BX 


:CURSor:MANual:TUNit 


MSO1000Z/DS1000Z Programming Guide 


Chapter 2 Command System RIGOL 


:CURSor:MANual: IXDELta? 


Syntax 


Description 


Return 
Format 


Example 


Related 
Commands 


:CURSor:MANual:IXDELta? 


Query the reciprocal of the absolute value of the difference between the X values of cursor 
A and cursor B (1/|dX|) in the manual cursor measurement mode. The unit depends on 
the horizontal unit currently selected. 


The query returns 1/|dX]| in scientific notation. 


:CURSor:MANual:IXDELta? /*The query returns 1.250000e+05*/ 
:CURSor:MANual:AX 

:CURSor:MANual:BX 

:CURSor:MANual:TUNit 


:CURSor:MANual:YDELta? 


Syntax 
Description 


Return 
Format 


Example 


Related 
Commands 


:CURSor:MANual:YDELta? 


Query the difference between the Y values of cursor A and cursor B (BY-AY) in the manual 
cursor measurement mode. The unit depends on the vertical unit currently selected. 


When the signal source is CHANnel1|CHANnel2|CHANnel3|CHANnel4| MATH, the query 
returns the difference in scientific notation; when the signal source is LA, the query 
returns 4294967295. 


:CURSor:MANual:YDELta? /*The query returns -4.000000e+00*/ 
:CURSor:MANual:AY 

:CURSor:MANual:BY 

:CURSor:MANual:VUNit 


MSO1000Z/DS1000Z Programming Guide 2-23 


RIGOL Chapter 2 Command System 
:CURSor:TRACk 


Command List: 

:CURSor: TRACk:SOURce1 
:CURSor: TRACK:SOURCce2 
:CURSor: TRACK:AX 
:CURSor: TRACk:BX 
:CURSor: TRACk:AY? 
:CURSor: TRACK:BY? 
:CURSor: TRACk:AXValue? 
:CURSor: TRACk:AYValue? 
:CURSor: TRACK: BxValue? 
:CURSor: TRACk:BYValue? 
:CURSor: TRACk:XDELta? 
:CURSor: TRACK: YDELta? 
:CURSor: TRACK: IXDELTA? 


Si A 2 A A A A A A A A A 


:CURSor:TRACk:SOURce1 
Syntax :CURSor:TRACk:SOURcel <source> 
:CURSor: TRACk:SOURce1? 


Description Set or query the channel source of cursor A in the track cursor measurement mode. 


Parameter Name Type Range Default 


{OFF]CHANnel1|CHANnel2|CHANnel3 | 
CHANnel4|MATH} 


Explanation Only the channels enabled can be selected as the channel source. 


Return The query returns OFF, CHAN1, CHAN2, CHAN3, CHAN4, or MATH. 
Format 


Example :CURSor:TRACk:SOURce1 CHANnel2 /*Set the channel source to CH2*/ 
:CURSor: TRACK: SOURce1? /*The query returns CHAN2*/ 


<source> | Discrete CHANnel1 
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:CURSor:TRACk:SOURce2 


Syntax :CURSor:TRACk:SOURce2 <source> 
:CURSor: TRACK: SOURce2? 
Description Set or query the channel source of cursor B in the track cursor measurement mode. 
Parameter Name Type Range Default 
<source> | Discrete east aaa CHANnelt1 
Explanation Only the channels enabled can be selected as the channel source. 
Return § The query returns OFF, CHAN1, CHAN2, CHAN3, CHAN4, or MATH. 
Format 
Example  :CURSor:TRACk:SOURce2 CHANnel2 /*Set the channel source to CH2*/ 
:CURSor: TRACK: SOURce2? /*The query returns CHAN2*/ 
:CURSor:TRACk:AX 
Syntax :CURSor:TRACk:AX <x> 
:CURSor: TRACk:AX? 
Description Set or query the horizontal position of cursor A in the track cursor measurement mode. 
Parameter Name Type Range Default 
<x> Integer 5 to 594 100 


Explanation 


Return 
Format 


Example 


The horizontal and vertical positions of the cursor are defined by the pixel coordinate of 
the screen. The pixel coordinate of the screen ranges from (0,0) to (600,400). Wherein, 
(0,0) is located at the left top corner of the screen and (600,400) is located at the right 
bottom corner of the screen. The horizontal pixel range is from 0 to 600 and the vertical 
pixel range is from 0 to 400. 


The query returns an integer between 5 and 594. 


:CURSor: TRACkK:AX 200 
:CURSor: TRACk:AX? 


/*Set the horizontal position of cursor A to 200*/ 
/*The query returns 200*/ 
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:CURSor:TRACk:BX 


Syntax 


:CURSor:TRACk:BX <x> 
:CURSor: TRACK: BX? 


Description Set or query the horizontal position of cursor B in the track cursor measurement mode. 
Parameter Name Type Range Default 
<x> Integer 5 to 594 500 
Explanation The horizontal and vertical positions of the cursor are defined by the pixel coordinate of 
the screen. The pixel coordinate of the screen ranges from (0,0) to (600,400). Wherein, 
(0,0) is located at the left top corner of the screen and (600,400) is located at the right 
bottom corner of the screen. The horizontal pixel range is from 0 to 600 and the vertical 
pixel range is from 0 to 400. 
Return § The query returns an integer between 5 and 594. 
Format 
Example  :CURSor:TRACk:BX 200 /*Set the horizontal position of cursor B to 200*/ 
:CURSor: TRACk: BX? /*The query returns 200*/ 
:CURSor:TRACk:AY? 
Syntax :CURSor:TRACk:AY? 
Description Query the vertical position of cursor A in the track cursor measurement mode. 
Explanation > _ The horizontal and vertical positions of the cursor are defined by the pixel coordinate 
of the screen. The pixel coordinate of the screen ranges from (0,0) to (600,400). 
Wherein, (0,0) is located at the left top corner of the screen and (600,400) is located 
at the right bottom corner of the screen. The horizontal pixel range is from 0 to 600 
and the vertical pixel range is from 0 to 400. 
> When cursor A exceeds the vertical range of the screen display, the query always 
returns 4294967295. 
Return The query returns an integer. 
Format 
Example  :CURSor:TRACk:AY? /*The query returns 284*/ 
:CURSor:TRACKk:BY? 
Syntax :CURSor:TRACk:BY? 
Description Query the vertical position of cursor B in the track cursor measurement mode. 
Explanation > _ The horizontal and vertical positions of the cursor are defined by the pixel coordinate 
of the screen. The pixel coordinate of the screen ranges from (0,0) to (600,400). 
Wherein, (0,0) is located at the left top corner of the screen and (600,400) is located 
at the right bottom corner of the screen. The horizontal pixel range is from 0 to 600 
and the vertical pixel range is from 0 to 400. 
> When cursor B exceeds the vertical range of the screen display, the query always 
returns 4294967295. 
Return The query returns an integer. 
Format 
Example  :CURSor:TRACk:BY? /*The query returns 200*/ 
2-26 MSO1000Z/DS1000Z Programming Guide 


Chapter 2 Command System RIGOL 


:CURSor:TRACk:AXValue? 
Syntax :CURSor:TRACk:AXValue? 
Description Query the X value of cursor A in the track cursor measurement mode. The default unit is s. 


Return The query returns the X value of cursor A in scientific notation. 
Format 


Example  :CURSor: TRACk:AXValue? /*The query returns -4.000000e-06*/ 


Related :CURSor: TRACk:AX 
Command 


:CURSor:TRACk:AYValue? 
Syntax :CURSor:TRACk:AYValue? 


Description Query the Y value of cursor A in the track cursor measurement mode. The unit is the same 
as the channel unit currently selected. 


Return The query returns the Y value of cursor A in scientific notation. 
Format 


Example  :CURSor:TRACk:AYValue? /*The query returns -4.000000e-01*/ 
Related :CHANnel<n>:UNITs 
Commands. cURsor:TRACK:AY? 


:CURSor:TRACk:BXValue? 
Syntax :CURSor:TRACk:BXValue? 
Description Query the X value of cursor B in the track cursor measurement mode. The default unit is s. 


Return The query returns the X value of cursor B in scientific notation. 
Format 


Example  :CURSor:TRACk:BXValue? /*The query returns 4.000000e-06*/ 


Related :CURSor: TRACk:BX 
Command 


:CURSor:TRACk:BYValue? 
Syntax :CURSor:TRACk:BYValue? 


Description Query the Y value of cursor B in the track cursor measurement mode. The unit is the same 
as the channel unit currently selected. 


Return The query returns the Y value of cursor B in scientific notation. 
Format 


Example  :CURSor:TRACk:BYValue? /*The query returns 4.000000e-01*/ 
Related :CHANnel<n>:UNITs 
Commands cursor: TRACK:BY? 
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:CURSor:TRACk:XDELta? 
Syntax :CURSor:TRACk:XDELta? 


Description Query the difference between the X values of cursor A and cursor B (BX-AX) in the track 
cursor measurement mode. The default unit is s. 


Return The query returns the difference in scientific notation. 
Format 


Example :CURSor:TRACk:XDELta? /*The query returns 8.000000e-06*/ 
Related :CURSor:TRACk:AX 


Commands :CURSor: TRACK:BX 


:CURSor:TRACk:YDELta? 
Syntax :CURSor:TRACk:YDELta? 


Description Query the difference between the Y values of cursor A and cursor B (BY-AY) in the track 
cursor measurement mode. The unit is the same as the channel unit currently selected. 


Return The query returns the difference in scientific notation. 
Format 


Example :CURSor:TRACk:YDELta? /*The query returns 8.000000e-01*/ 
Related :CURSor:TRACk:AY? 


Commands :CURSor: TRACK:BY? 


:CURSor: TRACK: IXDELTA? 
Syntax :CURSor:TRACk:IXDELTA? 


Description Query the reciprocal of the absolute value of the difference between the X values of cursor 
A and cursor B (1/|dX]) in the track cursor measurement mode. The default unit is Hz. 


Return The query returns 1/|dX| in scientific notation. 
Format 


Example :CURSor:TRACk:IXDELTA? /*The query returns 1.250000e+05*/ 


Related :CURSor:TRACk:AX 


Commands :CURSor: TRACK: BX 
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:CURSor:AUTO 


Command List: 
:CURSor:AUTO:ITEM 
:CURSor:AUTO:AX? 
:CURSor: AUTO: BX? 
:CURSor:AUTO:AY? 
:CURSor:AUTO:BY? 
:CURSor:AUTO:AXValue? 
:CURSor:AUTO:AYValue? 
:CURSor:AUTO:BXValue? 
:CURSor:AUTO:BYValue? 


, i 2 2 2 2 2 2 


:CURSor:AUTO:ITEM 


Syntax :CURSor:AUTO:ITEM <item> 


:CURSor:AUTO:ITEM? 


Description The auto cursor function can measure 37 waveform parameters. Using this command, 
you can select the parameters to be measured by the auto cursor from the five 
parameters enabled last or query the parameters currently measured by the auto cursor. 


Parameter Name 


Type 


Range 


Default 


<item> 


Discrete 


{OFF|ITEM1|ITEM2|ITEM3|ITEM4|ITEM5} 


OFF 


Explanation > This command is only valid when the auto cursor mode is selected. You can select 
the auto cursor measurement mode using the :CURSor:MODE command. 


> The 37 waveform parameters are listed below (see the detailed introduction 
in :MEASure Commands). The parameters can be enabled by the :MEASure:ITEM 


command. 
Period, Frequency, Rise Time, Fall Time, +Width, -Width, +Duty, -Duty, +Pulses, 
-Pulses, +Edges, -Edges, tVmax, tVmin, +Rate, +Rate, Delay + 1-2, Delay 

t 1-2, Phase + 12, Phase = 12, Vmax, Vmin, Vpp, Vtop, Vbase, Vamp, 
Vupper, Vmid, Vlower, Vavg, Vrms, Overshoot, Preshoot, Area, Period Area, Period 
Vrms, Variance. 


Return The query returns OFF, ITEM1, ITEM2, ITEM3, ITEM4, or ITEMS. 


Format 


Example :CURSor:AUTO:ITEM ITEM3 
:CURSor:AUTO:ITEM? 


/*The query returns ITEM3*/ 


/*Use auto cursor to measure ITEM3*/ 
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:CURSor:AUTO:AX? 
Syntax :CURSor:AUTO:AX? 
Description Query the horizontal position of cursor A in auto cursor measurement. 


Explanation > _ The horizontal and vertical positions of the cursor are defined by the pixel 
coordinate of the screen. The pixel coordinate of the screen ranges from (0,0) to 
(600,400). Wherein, (0,0) is located at the left top corner of the screen and 
(600,400) is located at the right bottom corner of the screen. The horizontal pixel 
range is from 0 to 600 and the vertical pixel range is from 0 to 400. 


> In auto cursor measurement, cursor A of X type is not required for some of the 
measurement items. At this point, the query returns 4294967295. 


Return The query returns an integer between 5 and 594. 
Format 


:CURSor:AUTO:BX? 
Syntax :CURSor:AUTO:BX? 
Description Query the horizontal position of cursor B in auto cursor measurement. 


Explanation > _ The horizontal and vertical positions of the cursor are defined by the pixel 
coordinate of the screen. The pixel coordinate of the screen ranges from (0,0) to 
(600,400). Wherein, (0,0) is located at the left top corner of the screen and 
(600,400) is located at the right bottom corner of the screen. The horizontal pixel 
range is from 0 to 600 and the vertical pixel range is from 0 to 400. 


> In auto cursor measurement, cursor B of X type is not required for some of the 
measurement items. At this point, the query returns 4294967295. 


Return The query returns an integer between 5 and 594. 
Format 


:CURSor:AUTO:AY? 
Syntax :CURSor:AUTO:AY? 
Description Query the vertical position of cursor A in auto cursor measurement. 


Explanation > _ The horizontal and vertical positions of the cursor are defined by the pixel 
coordinate of the screen. The pixel coordinate of the screen ranges from (0,0) to 
(600,400). Wherein, (0,0) is located at the left top corner of the screen and 
(600,400) is located at the right bottom corner of the screen. The horizontal pixel 
range is from 0 to 600 and the vertical pixel range is from 0 to 400. 


> In auto cursor measurement, cursor A of Y type is not required for some of the 
measurement items. At this point, the query returns 4294967295. 


Return The query returns an integer between 5 and 394. 
Format 
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:CURSor:AUTO:BY? 


Syntax 


:CURSor:AUTO:BY? 


Description Query the vertical position of cursor B in auto cursor measurement. 


Explanation > _ The horizontal and vertical positions of the cursor are defined by the pixel 


Return 
Format 


coordinate of the screen. The pixel coordinate of the screen ranges from (0,0) to 
(600,400). Wherein, (0,0) is located at the left top corner of the screen and 
(600,400) is located at the right bottom corner of the screen. The horizontal pixel 
range is from 0 to 600 and the vertical pixel range is from 0 to 400. 


> In auto cursor measurement, cursor B of Y type is not required for some of the 
measurement items. At this point, the query returns 4294967295. 


The query returns an integer between 5 and 394. 


:CURSor:AUTO:AXValue? 


Syntax 


Description 
Explanation 
Return 


Format 


Example 


:CURSor:AUTO:AXValue? 


Query the X value of cursor A in auto cursor measurement. The unit depends on the 
horizontal unit currently selected. 


In auto cursor measurement, cursor A of X type is not required for some of the 
measurement items. At this point, the query returns 9.9E37. 


The query returns the X value of cursor A in scientific notation. 


:CURSor:AUTO:AXValue? /*The query returns -4.000000e-06*/ 


:CURSor:AUTO:AYValue? 


Syntax 


Description 
Explanation 
Return 


Format 


Example 


:CURSor:AUTO:AYValue? 


Query the Y value of cursor A in auto cursor measurement. The unit depends on the 
vertical unit currently selected. 


In auto cursor measurement, cursor A of Y type is not required for some of the 
measurement items. At this point, the query returns 9.9E37. 


The query returns the Y value of cursor A in scientific notation. 


:CURSor:AUTO:AYValue? /*The query returns -4.000000e-01*/ 


:CURSor:AUTO:BXValue? 


Syntax 


Description 
Explanation 
Return 


Format 


Example 


:CURSor:AUTO:BxXValue? 


Query the X value of cursor B in auto cursor measurement. The unit depends on the 
horizontal unit currently selected. 


In auto cursor measurement, cursor B of X type is not required for some of the 
measurement items. At this point, the query returns 9.9E37. 


The query returns the X value of cursor B in scientific notation. 


:CURSor:AUTO:BXValue? /*The query returns -4.000000e-06*/ 
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:CURSor:AUTO:BYValue? 


Syntax 


Description 
Explanation 
Return 


Format 


Example 


:CURSor:AUTO:BYValue? 


Query the Y value of cursor B in auto cursor measurement. The unit depends on the 
vertical unit currently selected. 


In auto cursor measurement, cursor B of Y type is not required for some of the 
measurement items. At this point, the query returns 9.9E37. 


The query returns the Y value of cursor B in scientific notation. 


:CURSor:AUTO:BYValue? /*The query returns 4.000000e-01*/ 
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:CURSor:XY 


The :CURSor:XY commands can only be used when the horizontal timebase mode is XY. 


Command List: 
:CURSor:XY:AX 
:CURSor:XY:BX 
:CURSor:XY:AY 
:CURSor:XY: BY 
:CURSor:XY:AXValue? 
:CURSor:XY:AYValue? 
:CURSor:XY:BXValue? 
:CURSor:XY:BYValue? 


Se A A A A a 


:CURSor:XY:AX 
Syntax :CURSor:XY:AX <x> 
:CURSor:XY:AX? 


Description Set or query the horizontal position of cursor A in the XY cursor measurement mode. 


Parameter Name Type Range Default 


<xX> Integer 5 to 394 100 


Explanation In the XY timebase mode, the horizontal and vertical positions of the cursor are defined 
by the pixel coordinate of the XY display area. The pixel coordinate of the screen ranges 
from (0,0) to (400,400). Wherein, (0,0) is located at the right top corner and (400,400) is 
located at the left bottom corner. The horizontal and vertical pixel ranges are both from 0 


to 400. 
Return § The query returns an integer between 5 and 394. 
Format 
Example  :CURSor:XY:AX 200 /*Set the horizontal position of cursor A to 200*/ 
:CURSor:XY:AX? /*The query returns 200*/ 
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:CURSor:XY:BX 
Syntax :CURSor:XY:BX <x> 
:CURSor:XY:BX? 
Description Set or query the horizontal position of cursor B in the XY cursor measurement mode. 
Parameter Name Type Range Default 
<x> Integer 5 to 394 300 
Explanation In the XY timebase mode, the horizontal and vertical positions of the cursor are defined 
by the pixel coordinate of the XY display area. The pixel coordinate of the screen ranges 
from (0,0) to (400,400). Wherein, (0,0) is located at the right top corner and (400,400) is 
located at the left bottom corner. The horizontal and vertical pixel ranges are both from 0 
to 400. 
Return The query returns an integer between 5 and 394. 
Format 
Example :CURSor:XY:BX 200 /*Set the horizontal position of cursor B to 200*/ 
:CURSor:XY:BX? /*The query returns 200*/ 
:CURSor:XY:AY 
Syntax :CURSor:XY:AY <y> 
:CURSor:XY:AY? 
Description Set or query the vetical position of cursor A in the XY cursor measurement mode. 
Parameter Name Type Range Default 
<x> Integer 5 to 394 100 
Explanation In the XY timebase mode, the horizontal and vertical positions are defined by the pixel 
coordinate of the XY display area. The pixel coordinate of the screen ranges from (0,0) to 
(400,400). Wherein, (0,0) is located at the right top corner and (400,400) is located at the 
left bottom corner. The horizontal and vertical pixel ranges are both from 0 to 400. 
Return The query returns an integer between 5 and 394. 
Format 
Example  :CURSor:XY:AY 200 /*Set the vertical position of cursor A to 200*/ 
:CURSor:XY:AY? /*The query returns 200*/ 
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:CURSor:XY:BY 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


:CURSor:XY:BY <y> 
:CURSor:XY:BY? 
Set or query the vertical position of cursor B in the XY cursor measurement mode. 


Name Type Range Default 


<xX> Integer 5 to 394 300 


In the XY timebase mode, the horizontal and vertical positions are defined by the pixel 
coordinate of the XY display area. The pixel coordinate of the XY display area ranges from 
(0,0) to (400,400). Wherein, (0,0) is located at the right top corner and (400,400) is 
located at the left bottom corner. The horizontal and vertical pixel ranges are both from 0 
to 400. 


The query returns an integer between 5 and 394. 


:CURSor:XY:BY 200 /*Set the vertical position of cursor B to 200*/ 
:CURSor:XY:BY? /*The query returns 200*/ 


:CURSor:XY:AXValue? 


Syntax 


Description 


Return 
Format 


Example 


Related 
Command 


:CURSor:XY:AXValue? 


Query the X value of cursor A in the XY cursor measurement mode. The unit depends on 
the amplitude unit of the corresponding channel. 


The query returns the X value of cursor A in scientific notation. 


:CURSor:XY:AXValue? /*The query returns 2.000000e+00*/ 
:CHANnel<n>:UNITs 


:CURSor:XY:AYValue? 


Syntax 


Description 


Return 
Format 


Example 


Related 
Command 


:CURSor:XY:AYValue? 


Query the Y value of cursor A in the XY cursor measurement mode. The unit depends on 
the amplitude unit of the corresponding channel. 


The query returns the Y value of cursor A in scientific notation. 


:CURSor:XY:AYValue? /*The query returns 2.000000e+00*/ 
:CHANnel<n>:UNITs 
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Query the X value of cursor B in the XY cursor measurement mode. The unit depends on 
the amplitude unit of the corresponding channel. 


The query returns the X value of cursor B in scientific notation. 


/*The query returns -2.000000e+00*/ 


Query the Y value of cursor B in the XY cursor measurement mode. The unit depends on 
the amplitude unit of the corresponding channel. 


The query returns the Y value of cursor B in scientific notation. 


Syntax :CURSor:XY:BXValue? 
Description 
Return 
Format 
Example  :CURSor:XY:BXValue? 
Related :CHANnel<n>:UNITs 
Command 
:CURSor:XY:BYValue? 
Syntax :CURSor:XY:BYValue? 
Description 
Return 
Format 
Example :CURSor:XY:BYValue? 
Related :CHANnel<n>:UNITs 
Command 


/*The query returns -2.000000e+00*/ 


MSO1000Z/DS1000Z Programming Guide 


Chapter 2 Command System RIGOL 


:DECoder Commands 


The :DECoder commands are used to execute decoding settings and operations. 


Command List: 

:DECoder<n>:MODE 
:DECoder<n>:DISPlay 
:DECoder<n>:FORMat 
:DECoder<n>:POSition 
:DECoder<n>:THREshold: CHANnel1 
:DECoder<n>:THREshold: CHANnel2 
:DECoder<n>:THREshold: CHANnel3 
:DECoder<n>:THREshold: CHANnel4 
:DECoder<n>:THREshold:AUTO 
:DECoder<n>:CONFig:LABel 
:DECoder<n>:CONFig:LINE 
:DECoder<n>:CONFig:FORMat 
:DECoder<n>:CONFig:ENDian 
:DECoder<n>:CONFig:WIDth 
:DECoder<n>:CONFig:SRATe? 
:DECoder<n>:UART 
:DECoder<n>:IIC 

:DECoder<n>:SPI 
:DECoder<n>:PARallel 


fee HHH HHH HHH HO O 


:-DECoder<n>:MODE 
Syntax :DECoder<n>:MODE <mode> 
:DECoder<n>:MODE? 


Description Set or query the decoder type. 


Parameter Name Type Range Default 
<n> Discrete | {1]2} = 
<mode> _ | Discrete | {PARallel|UART|SPI|IIC} PARallel 


Explanation PARallel, UART, SPI, and IIC correspond to parallel decoding, RS232 decoding, SPI 
decoding, and I2C decoding respectively. 


Return The query returns PAR, UART, SPI, or IIC. 
Format 


Example :DECoderi:MODE SPI /*Set the decoder type to SPI*/ 
:DECoder1:MODE? /*The query returns SPI*/ 
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:-DECoder<n>:DISPlay 
Syntax :DECoder<n>:DISPlay <bool> 
:DECoder<n>:DISPlay? 


Description Turn on or off the decoder or query the status of the decoder. 


Parameter Name Type Range Default 
<n> Discrete {1|2} -- 
<bool> Bool {{1]ON}|{0|OFF}} 0|OFF 

Return The query returns 1 or 0. 
Format 
Example :DECoderi:DISPlay ON /*Turn on Decoder 1*/ 
:DECoder1:DISPlay? /*The query returns 1*/ 
:-DECoder<n>:FORMat 


Syntax :DECoder<n>:FORMat <fmt> 
:DECoder<n>:FORMat? 


Description Set or query the bus display format. 


Parameter Name Type Range Default 
<n> Discrete {1|2} = 
<fmt> Discrete | {HEX|ASCii|DEC|BIN|LINE} ASCii 


Explanation > HEX: hexadecimal; DEC: decimal; BIN: binary 


> In LINE format, the actual values of the bus are displayed in binary form and the 
order is consistent with the bus transmission order. This format is only valid for 
serial buses which include LSB and MSB endian. If MSB endian is selected, LINE 
format is the same as binary. 


Return The query returns HEX, ASC, DEC, BIN, or LINE. 
Format 


Example :DECoder1:FORMat HEX /*Set the bus display format to hexadecimal*/ 
:DECoderi:FORMat? /*The query returns HEX*/ 
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:-DECoder<n>:POSition 
Syntax :DECoder<n>:POSition <pos> 
:DECoder<n>:POSition? 


Description Set or query the vertical position of the bus on the screen. 


Parameter Name Type Range Default 
<n> Discrete | {1|2} -- 


Decoder 1: 350 
Decoder 2: 300 


Explanation The screen is divided into 400 parts vertically which are marked as 0 to 400 from top to 
bottom respectively. The range of <pos> is from 50 to 350. 


<pos> Integer | 50 to 350 


Return The query returns an integer between 50 and 350. 
Format 


Example :DECoder1i:POSition 300 /*Set the vertical position of the bus to 300*/ 
:DECoder1:POSition? /*The query returns 300*/ 
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:-DECoder<n>:THREshold:CHANnel1 
:-DECoder<n>:THREshold:CHANnel2 
-DECoder<n>:THREshold:CHANnel3 
:-DECoder<n>:THREshold:CHANnel4 


Syntax :DECoder<n>:THREshold:CHANnel1 <thre> 
:DECoder<n>:THREshold: CHANnel1? 
:DECoder<n>:THREshold:CHANnel2 <thre> 
:DECoder<n>:THREshold: CHANnel2? 
:DECoder<n>:THREshold:CHANnel3 <thre> 
:DECoder<n>:THREshold:CHANnel3? 
:DECoder<n>:THREshold:CHANnel4 <thre> 
:DECoder<n>:THREshold: CHANnel4? 


Chapter 2 Command System 


Description Set or query the threshold level of the specified analog channel. 
Parameter Name Type Range Default 
<n> Discrete {1]2} - 
(-4 x VerticalScale - VerticalOffset) to _ 
adc oases (4 x VerticalScale - VerticalOffset) 
Explanation > _ VerticalScale is the vertical scale of the specified analog channel. VerticalOffset is the 


vertical position of the specified analog channel. 


> By default, the auto threshold function of the analog channels of the oscilloscope is 
turned on. To set the threshold level manually, send 
the :DECoder<n>:THREshold:AUTO command to turn off the auto threshold 


function. 


Return The query returns the level in scientific notation. 


Format 


Example :DECoderi:THREshold:CHANnel4 1.5 /*Set the threshold level of CH4 to 1.5V*/ 
:DECoder1:THREshold:CHANnel4? /*The query returns 1.500000e+00*/ 
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-DECoder<n>:THREshold:AUTO 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


Related 
Commands 


:DECoder<n>:THREshold:AUTO <bool> 
:DECoder<n>:THREshold:AUTO? 


Turn on or off the auto threshold function of the analog channels, or query the status of 
the auto threshold function of the analog channels. 


Name Type Range Default 
<n> Discrete | {1|2} -- 
<bool> Bool {{1]ON}|{0|OFF}} 1|ON 


By default, the auto threshold function of the analog channels of the oscilloscope is 
turned on. To set the threshold level manually, send this command to turn off the auto 
threshold function and use the commands in Related Commands to set the threshold 
manually. 


The query returns 1 or 0. 


:DECoder1:THREshold:AUTO OFF 
:DECoder1:THREshold:AUTO? 


:DECoder<n>:THREshold:CHANnel1 
:DECoder<n>:THREshold:CHANnel2 
:DECoder<n>:THREshold:CHANnel3 
:DECoder<n>:THREshold:CHANnel4 


/*Turn off the auto threshold function*/ 
/*The query returns 0*/ 


-DECoder<n>:CONFig:LABel 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


:DECoder<n>:CONFig:LABel <bool> 
:DECoder<n>:CONFig:LABel? 


Turn on or off the label display function, or query the status of the label display function. 


Name Type Range Default 
<n> Discrete | {1|2} -- 
<bool> Bool {{1]ON}|{0|OFF}} 1/ON 


When this function is turned on, the bus label will be displayed at the lower-upper side of 
the bus (when the bus display is turned on). 


The query returns 1 or 0. 


:DECoder1:CONFig:LABel ON 
:DECoder1:CONFig:LABel? 


/*Turn on the label display function*/ 
/*The query returns 1*/ 
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:-DECoder<n>:CONFig:LINE 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


:DECoder<n>:CONFig:LINE <bool> 
:DECoder<n>:CONFig:LINE? 


Turn on or off the bus display function, or query the status of the bus display function. 


Name Type Range Default 
<n> Discrete | {1|2} -- 
<bool> Bool {{1]ON}|{0|OFF}} 1|ON 


When this function is enabled, the bus will be displayed on the screen. You can send 
the :DECoder<n>:POSition command to adjust the vertical display position of the bus. 


The query returns 1 or 0. 


/*Turn off the bus display function*/ 
/*The query returns 0*/ 


:DECoder1:CONFig:LINE OFF 
:DECoder1:CONFig:LINE? 


:-DECoder<n>:CONFig:FORMat 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


:DECoder<n>:CONFig:FORMat <bool> 
:DECoder<n>:CONFig:FORMat? 


Turn on or off the format display function, or query the status of the format display 
function. 


Name Type Range Default 
<n> Discrete | {1|2} -- 
<bool> Bool {{1]ON}|{0|OFF}} 1|ON 


When this function is turned on, the current bus display format will be displayed at the 
right of the label display (when the bus display is turned on). You can send 
the :DECoder<n>:FORMat command to set the bus display format. 


The query returns 1 or 0. 


/*Turn off the format display function*/ 
/*The query returns 0*/ 


:DECoder1:CONFig:FORMat OFF 
:DECoder1:CONFig:FORMat? 
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:-DECoder<n>:CONFig:ENDian 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


:DECoder<n>:CONFig:ENDian <bool> 
:DECoder<n>:CONFig:ENDian? 


Turn on or off the endian display function in serial bus decoding, or query the status of 
the endian display function in serial bus decoding. 


Name Type Range Default 
<n> Discrete | {1]2} -- 
<bool> Bool {{1]ON}|{0|OFF}} 0|OFF 


> This command is invalid in parallel decoding. 


> When this function is enabled, the current bus endian will be displayed at the right of 
the format display (when the bus display is turned on). 


The query returns 1 or 0. 


/*Turn on the endian display function*/ 
/*The query returns 1*/ 


:DECoder1:CONFig:ENDian ON 
:DECoder1:CONFig:ENDian? 


:-DECoder<n>:CONFig:WIDth 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


:DECoder<n>:CONFig:WIDth <bool> 
:DECoder<n>:CONFig:WIDth? 


Turn on or off the width display function, or query the status of the width display 
function. 


Name Type Range Default 
<n> Discrete | {1|2} - 
<bool> Bool {{1]ON}|{0|OFF}} 0|OFF 


When this function is enabled, the width of each frame of data will be displayed at the 
right of the endian display (when the bus display is turned on). 


The query returns 1 or 0. 


/*Turn on the width display function*/ 
/*The query returns 1*/ 


:DECoder1:CONFig:WIDth ON 
:DECoder1:CONFig:WIDth? 


:-DECoder<n>:CONFig:SRATe? 


Syntax 
Description 


Parameter 


Explanation 


Return 
Format 


Example 


:DECoder<n>:CONFig:SRATe? 


Query the current digital sample rate. 


Name Range Default 


{1]2} = 


The digital sample rate is related to the data source currently selected. By default, the 
data source is "Trace"; at this point, the digital sample rate is related to the horizontal 
time base. 


Type 


Discrete 


<n> 


The query returns the digital sample rate in scientific notation. 


:DECoder1:CONFig:SRATe? /*The query returns 1.000000e+08*/ 
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The :DECoder<n>:UART commands are used to set the RS232 decoding parameters. 


Command List: 
:DECoder<n>:UART:TX 
:DECoder<n>:UART:RX 


:DECoder<n>:UART:POLarity 


:DECoder<n>:UART:ENDian 
:DECoder<n>:UART:BAUD 
:DECoder<n>:UART:WIDTh 


Se A A A A A 


:DECoder<n>:UART:STOP 
:DECoder<n>:UART:PARity 


:DECoder<n>:UART:TX 
:DECoder<n>:UART:TX <tx> 
:DECoder<n>:UART:TX? 

Set or query the TX channel source of RS232 decoding. 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


Name | Type Range Default 

<n> Discrete | {1|2} =a 
{D0|D1|D2|D3|D4|D5|D6|D7|D8| 

<tx> Discrete | D9|D10|D11|D12|D13|D14|D15] CHANnel1 
CHANnel1|CHANnel2| CHANnel3|CHANnel4|OFF} 


When OFF is selected, no TX channel source will be set. The TX channel source and RX 
channel source (:DECoder<n>:UART:RX) cannot be both set to OFF. 


The query returns DO, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D1i2, D13, D14, 


D15, CHAN1, CHAN2, CHAN3, CHAN4, or OFF. 


:DECoder1:UART:TX CHAN2 


:DECoder1:UART: TX? 


/*Set the TX channel source to CH2*/ 
/*The query returns CHAN2*/ 
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:DECoder<n>:UART:RX 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


RIGOL 
:DECoder<n>:UART:RX <rx> 
:DECoder<n>:UART:RX? 
Set or query the RX channel source of RS232 decoding. 
Name | Type Range Default 
<n> Discrete {1|2} == 
{D0|D1|D2|D3|D4|D5|D6|D7|D8| 
<Irx> Discrete D9|D10]D11]D12]D13|D14]D15]| OFF 
CHANnel1| CHANnel2|CHANnel3|CHANnel4| OFF} 


When OFF is selected, no RX channel source will be set. The RX channel source and TX 
channel source (:DECoder<n>:UART:TX) cannot be both set to OFF. 


The query returns DO, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, 
D15, CHAN1, CHAN2, CHAN3, CHAN4, or OFF. 


:DECoder1:UART:RX CHAN4 /*Set the RX channel source to CH4*/ 
:DECoder1:UART:RX? /*The query returns CHAN4*/ 


:DECoder<n>:UART:POLarity 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


:DECoder<n>:UART:POLarity <pol> 
:DECoder<n>:UART:POLarity? 
Set or query the polarity of RS232 decoding. 


Name | Type Range Default 
<n> Discrete {1|2} a= 
<pol> | Discrete {NEGative] POSitive} POSitive 


> NEGative: negative polarity (_1m__)¥ namely high level is 0 and low level is 1. The 
RS232 standard uses negative polarity. 


>  POSitive: positive polarity (nls), namely high level is 1 and low level is 0. 
The query returns NEG or POS. 


:DECoder1:UART:POLarity NEGative /*Set the polarity of RS232 decoding to 
negative*/ 


:DECoder1:UART:POLarity? /*The query returns NEG*/ 
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:DECoder<n>:UART:ENDian 


Syntax :DECoder<n>:UART:ENDian <endian> 
:DECoder<n>:UART:ENDian? 
Description Set or query the endian of RS232 decoding. 

Parameter Name Type Range Default 
<n> Discrete | {1|2} -- 
<endian> | Discrete | {LSB|MSB} LSB 

Return The query returns LSB or MSB. 
Format 
Example :DECoder1:UART:ENDian MSB /*Set the endian of RS232 decoding to MSB*/ 


:DECoder1:UART:ENDian? /*The query returns MSB*/ 


:DECoder<n>:UART:BAUD 


Syntax :DECoder<n>:UART:BAUD <baud> 
:DECoder<n>:UART:BAUD? 
Description Set or query the buad rate of RS232 decoding. The default unit is bps (baud per second). 
Parameter Name Type Range Default 
<n> Discrete | {1]2} -- 
<baud> Integer | 110 to 20M 9600 
Return The query returns the current baud rate in integer. 
Format 
Example :DECoder1:UART:BAUD 57600 /*Set the buad rate of RS232 decoding to 57600bps*/ 


:DECoder1:UART:BAUD? /*The query returns 57600*/ 


:DECoder<n>:UART:WIDTh 


Syntax :DECoder<n>:UART:WIDTh <wid> 
:DECoder<n>:UART:WIDTh? 
Description Set or query the width of each frame of data in RS232 decoding. 
Parameter Name Type Range Default 

<n> Discrete | {1]2} -- 
<wid> Integer | 5 to8 8 

Return The query returns an integer between 5 and 8. 

Format 

Example :DECoder1:UART:WIDTh 7 /*Set the data width in RS232 decoding to 7*/ 


:DECoder1:UART:WIDTh? /*The query returns 7*/ 
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:DECoder<n>:UART:STOP 
Syntax :DECoder<n>:UART:STOP <stop> 
:DECoder<n>:UART:STOP? 
Description Set or query the stop bit after each frame of data in RS232 decoding. 


Parameter Name Type Range Default 
<n> Discrete | {1|2} = 
<stop> Discrete | {1]1.5|2} 1 


Return The query returns 1, 1.5, or 2. 
Format 


Example :DECoder1:UART:STOP 1.5 /*Set the stop bit in RS232 decoding to 1.5*/ 
:DECoder1:UART:STOP? /*The query returns 1.5*/ 


:DECoder<n>:UART:PARity 
Syntax :DECoder<n>:UART:PARity <parity> 
:DECoder<n>:UART:PARity? 


Description Set or query the even-odd check mode of the data transmission in RS232 decoding. 


Parameter Name Type Range Default 
<n> Discrete | {1|2} -- 
<parity> | Discrete | {NONE|EVEN|ODD} NONE 
Return The query returns NONE, EVEN, or ODD. 
Format 
Example :DECoder1:UART:PARity ODD Mie the even-odd check mode in RS232 decoding to 
:DECoder1:UART:PARity? jen ay returns ODD*/ 
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-DECoder<n>:IIC 


The :DECoder<n>:IIC commands are used to set the I2C decoding parameters. 


Command List: 
@ :DECoder<n>:IIC:CLK 
@ :DECoder<n>:IIC:DATA 


@ :DECoder<n>:IIC:ADDRess 


:DECoder<n>:IIC:CLK 


Syntax 


Description 


Parameter 


Return 
Format 


Example 


:DECoder<n>:IIC:CLK <clk> 
:DECoder<n>:IIC:CLK? 


Set or query the signal source of the clock channel in I2C decoding. 


Name _ | Type Range Default 

<n> Discrete | {1|2} -- 
{D0|D1|D2|D3|D4|D5|D6|D7|D8| 

<clk> Discrete | D9|D10|D11|]D12|D13|D14|D15| CHANnelt1 
CHANnel1|CHANnel2|CHANnel3|CHANnel4} 


The query returns DO, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, 
D15, CHAN1, CHAN2, CHAN3, or CHAN4. 


:DECoder1:IIC:CLK DO /*Set the signal source of the clock channel in I2C decoding 
to DO*/ 


:DECoder1:IIC:CLK? /*The query returns DO*/ 


:DECoder<n>:IIC:DATA 


Syntax 


Description 


Parameter 


Return 
Format 


Example 


:DECoder<n>:IIC:DATA <dat> 
:DECoder<n>:IIC:DATA? 


Set or query the signal source of the data channel in I2C decoding. 


Name Type Range Default 

<n> Discrete | {1|2} -- 
{D0|D1|D2|D3|D4]D5|D6|D7|D8| 

<dat> Discrete | D9|D10|D11|]D12|D13|D14|D15| CHANnel2 
CHANnel1| CHANnel2|CHANnel3|CHANnel4} 


The query returns DO, D1, D2, D3, D4, D5, D6, D7, D8, DI, D10, D11, D12, D13, D14, 
D15, CHAN1, CHAN2, CHAN3, or CHAN4. 


:DECoder1:IIC:DATA D1 /*Set the signal source of the data channel in I2C decoding 
to D1i*/ 


:DECoder1:IIC:DATA? /*The query returns D1*/ 
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:DECoder<n>:IIC:ADDRess 
Syntax :DECoder<n>:IIC:ADDRess <addr> 
:DECoder<n>:IIC:ADDRess? 


Description Set or query the address mode of I2C decoding. 


Parameter Name _ | Type Range Default 
<n> Discrete | {1]2} -- 
<addr> | Discrete | {NORMal|RW} NORMal 


Explanation > NORMal: the address bits (: TRIGger:IIC:AWIDth) does not include the R/W bit. 
> RW: the address bits (: TRIGger:IIC: AWIDth) includes the R/W bit. 


Return The query returns NORM or RW. 
Format 


Example :DECoderi:IIC:ADDRess RW /*Set the address of I2C decoding to include the R/W 
bit*/ 
:DECoder1 :IIC:ADDRess? /*The query returns RW*/ 
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:-DECoder<n>:SPI 


The :DECoder<n>:SPI commands are used to set the SPI decoding parameters. 


Command List: 
:DECoder<n>:SPI:CLK 
:DECoder<n>:SPI:MISO 
:DECoder<n>:SPI:MOSI 
:DECoder<n>:SPI:CS 
:DECoder<n>:SPI:SELect 
:DECoder<n>:SPI:MODE 
:DECoder<n>:SPI:TIMeout 
:DECoder<n>:SPI:POLarity 
:DECoder<n>:SPI:EDGE 
:DECoder<n>:SPI:ENDian 
:DECoder<n>:SPI:WIDTh 


ee 6% OO OO 


:DECoder<n>:SPI:CLK 
Syntax :DECoder<n>:SPI:CLK <clk> 
:DECoder<n>:SPI:CLK? 


Description Set or query the signal source of the clock channel in SPI decoding. 


Parameter Name Type Range Default 


<n> Discrete | {1|2} - 


{D0|D1|D2|D3|D4]D5|D6|D7|D8| 
<clk> Discrete | D9|D10|D11|D12|D13|D14|D15| CHANnel1 
CHANnel1|CHANnel2|CHANnel3|CHANnel4} 


Return The query returns DO, Di, D2, D3, D4, D5, D6, D7, D8, D9, D10, Di1, D12, D13, D14, 
Format D15, CHANi, CHAN2, CHAN3, or CHAN4. 


Example :DECoder1:SPI:CLK DO /*Set the signal source of the clock channel in SPI decoding 
to DO*/ 
:DECoder1:SPI:CLK? /*The query returns DO*/ 
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:DECoder<n>:SPI:MISO 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 
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:DECoder<n>:SPI:MISO <miso> 
:DECoder<n>:SPI:MISO? 
Set or query the MISO channel source in SPI decoding. 
Name Type Range Default 
<n> Discrete | {1|2} = 
{D0|D1|D2|D3]D4|D5|D6|D7|D8| 
<miso> | Discrete | D9|D10]D11]D12|D13|]D14|D15| OFF 
CHANnel1|CHANnel2|CHANnel3|CHANnel4|OFF} 


When OFF is selected, no MISO channel source will be set. The MISO channel source and 
MOSI channel source (:DECoder<n>:SPI:MOSI) cannot be both set to OFF. 


The query returns DO, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, 
D1i5, CHAN1, CHAN2, CHAN3, CHAN4, or OFF. 


:DECoder1:SPI:MISO DO 
:DECoder1:SPI:MISO? 


/*Set the MISO channel source in SPI decoding to DO*/ 
/*The query returns DO*/ 


:DECoder<n>:SPI:MOSI 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


:DECoder<n>:SPI:MOSI <mosi> 
:DECoder<n>:SPI:MOSI? 
Set or query the MOSI channel source in SPI decoding. 


Name _ | Type Range Default 

<n> Discrete | {1|2} -- 
{D0|D1|D2|D3|D4|D5|D6|D7|D8| 

<mosi> | Discrete | D9|D10|D11|D12|D13|D14|D15]| CHANnel2 
CHANnel1|CHANnel2|CHANnel3|CHANnel4|OFF} 


When OFF is selected, no MOSI channel source will be set. The MOSI channel source and 
MISO channel source (:DECoder<n>:SPI:MISO) cannot be both set to OFF. 


The query returns DO, D1, D2, D3, D4, D5, D6, D7, D8, DI, D10, D11, D12, D13, D14, 
D1i5, CHAN1, CHAN2, CHAN3, CHAN4, or OFF. 


:DECoder1:SPI:MOSI D1 
:DECoder1:SPI:MOSI? 


/*Set the MOSI channel source in SPI decoding to D1*/ 
/*The query returns D1i*/ 
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:DECoder<n>:SPI:CS 
Syntax :DECoder<n>:SPI:CS <cs> 
:DECoder<n>:SPI:CS? 


Description Set or query the CS channel source in SPI decoding. 


Parameter Name Type Range Default 
<n> Discrete | {1|2} == 
{D0|D1|D2|D3|D4|D5|D6|D7|D8| 
<cs> Discrete | D9|D10]D11]D12]D13|D14|D15| CHANnel3 
CHANnel1|CHANnel2|CHANnel3|CHANnel4} 


Explanation This command is only valid in the CS mode (:DECoder<n>:SPI:MODE). 


Return The query returns DO, Di, D2, D3, D4, D5, D6, D7, D8, DI, D10, D11, D12, D13, D14, 
Format D15, CHANi, CHAN2, CHAN3, or CHAN4. 


Example :DECoder1:SPI:CS CHANnel4 /*Set the CS channel source in SPI decoding to CH4*/ 
:DECoder1:SPI:CS? /*The query returns CHAN4*/ 


:DECoder<n>:SPI:SELect 
Syntax :DECoder<n>:SPI:SELect <CsNcs> 
:DECoder<n>:SPI:SELect? 
Description Set or query the CS polarity in SPI decoding. 


Parameter Name Type Range Default 
<n> Discrete | {1]2} -- 
<CsNcs> | Discrete | {NCS|CS} NCS 


Explanation > NCS: low level is valid (en). The instrument starts transmitting data when the 


CS is high. 
> This command is only valid in the CS mode (:DECoder<n>:SPI:MODE). 


Return The query returns NCS or CS. 
Format 


Example :DECoder1:SPI:SELect CS /*Set the CS polarity to high level is valid*/ 
:DECoder1:SPI:SELect? /*The query returns CS*/ 
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:DECoder<n>:SPI:MODE 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


RIGOL 
:DECoder<n>:SPI:MODE <CsTmo> 
:DECoder<n>:SPI:MODE? 
Set or query the frame synchronization mode of SPI decoding. 
Name Type Range Default 
<n> Discrete | {1|2} = 
<CsTmo> | Discrete | {CS|TIMeout} TIMeout 


> CS: it contains a chip select line (CS). You can perform frame synchronization 
according to CS. At this point, you need to send the :DECoder<n>:SPI:CS 
and :DECoder<n>:SPI:SELect commands to set the CS channel source and polarity. 


>  TIMeout: you can perform frame synchronization according to the timeout time. At 
this point, you need to send the :DECoder<n>:SPI:TIMeout command to set the 
timeout time. 


The query returns CS or TIM. 


:DECoder1:SPI:MODE CS _ /*Set the frame synchronization mode of SPI decoding to 
CS*/ 


:DECoder1:SPI:MODE? /*The query returns CS*/ 


:DECoder<n>:SPI:TIMeout 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


:DECoder<n>:SPI:TIMeout <tmo> 
:DECoder<n>:SPI:TIMeout? 


Set or query the timeout time in the timeout mode of SPI decoding. The default unit is s. 


Name Type Range Default 
<n> Discrete | {1|2} -- 
<tmo> Real Refer to Explanation 1.00us 


> The timeout time should be greater than the maximum pulse width of the clock and 
lower than the idle time between frames. 


> This command is only valid in the timeout mode (:DECoder<n>:SPI:MODE). 


The query returns the timeout time in scientific notation. 


:DECoder1:SPI:TIMeout 0.000005 
:DECoder1:SPI:TIMeout? 


/*Set the timeout time to 5us*/ 
/*The query returns 5.000000e-06*/ 
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:DECoder<n>:SPI:POLarity 


Syntax :DECoder<n>:SPI:POLarity <pol> 
:DECoder<n>:SPI:POLarity? 
Description Set or query the polarity of the SDA data line in SPI decoding. 

Parameter Name Type Range Default 
<n> Discrete | {1|2} -- 
<pol> Discrete | {NEGative|POSitive} POSitive 

Explanation > NEGative: HMM. The low level is 1. 
> POSitive: HMM. The high level is 1. 
Return The query returns NEG or POS. 
Format 
Example :DECoder1:SPI:POLarity NEG ative /*Set the polarity of the SDA data line in SPI 


decoding to negative*/ 


:DECoder1:SPI:POLarity? /*The query returns NEG*/ 


:DECoder<n>:SPI:EDGE 


Syntax :DECoder<n>:SPI:EDGE <edge> 
:DECoder<n>:SPI:EDGE? 
Description Set or query the clock type when the instrument samples the data line in SPI decoding. 
Parameter Name Type Range Default 
<n> Discrete | {1|2} = 
<edge> Discrete | {RISE|FALL} RISE 
Return § The query returns RISE or FALL. 
Format 
Example :DECoder1:SPI:EDGE FALL /*Set the instrument to sample data on the falling edge 


of the clock in SPI decoding*/ 


:DECoder1:SPI:EDGE? /*The query returns FALL*/ 


:DECoder<n>:SPI:ENDian 


Syntax :DECoder<n>:SPI:ENDian <endian> 
:DECoder<n>:SPI:ENDian? 
Description Set or query the endian of the SPI decoding data. 

Parameter Name Type Range Default 
<n> Discrete | {1|2} -- 
<endian> | Discrete | {LSB|MSB} MSB 

Return The query returns LSB or MSB. 
Format 
Example :DECoderi:SPI:ENDian MSB /*Set the data endian of the SPI decoding to MSB*/ 


:DECoder1:SPI:ENDian? /*The query returns MSB*/ 
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:DECoder<n>:SPI:WIDTh 


Syntax 


Description 


Parameter 


Return 
Format 


Example 


:DECoder<n>:SPI:WIDTh <wid> 


:DECoder<n>:SPI:WIDTh? 


Set or query the number of bits of each frame of data in SPI decoding. 


RIGOL 


Name Type 


Range 


Default 


<n> Discrete 


{1|2} 


<wid> Integer 


8 to 32 


The query returns an integer between 8 and 32. 


:DECoder1:SPI:WIDTh 16 
:DECoder1:SPI:WIDTh? 


/*Set the data width in SPI decoding to 16*/ 
/*The query returns 16*/ 
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:-DECoder<n>:PARallel 


The :DECoder<n>:PARallel commands are used to set the parallel decoding parameters. 


Command List: 
:DECoder<n>:PARallel:CLK 
:DECoder<n>:PARallel: EDGE 
:DECoder<n>:PARallel: WIDTh 
:DECoder<n>:PARallel:BITX 
:DECoder<n>:PARallel:SOURce 
:DECoder<n>:PARallel:POLarity 
:DECoder<n>:PARallel: NREJect 
:DECoder<n>:PARallel:NRTime 
:DECoder<n>:PARallel:CCOMpensation 
:DECoder<n>:PARallel: PLOT 


5 i A A A A A A A A 


:DECoder<n>:PARallel:CLK 
Syntax :DECoder<n>:PARallel:CLK <clk> 
:DECoder<n>:PARallel:CLK? 


Description Set or query the CLK channel source of parallel decoding. 


Parameter Name_ | Type Range Default 
<n> Discrete | {1|2} = 
{D0|D1|D2|D3|D4|D5|D6|D7|D8| 
<clk> Discrete | D9|D10|D11|D12|D13|D14|D15] CHANnel1 
CHANneli|CHANnel2|CHANnel3|CHANnel4|OFF} 


Return The query returns DO, Di, D2, D3, D4, D5, D6, D7, D8, D9, D10, Di1, D12, D13, D14, 
Format D15, CHANi1, CHAN2, CHAN3, CHAN4, or OFF. 


Example :DECoder1:PARallel:CLK DO /*Set the CLK channel source of parallel decoding to 
DO*/ 
:DECoder1:PARallel: CLK? /*The query returns DO*/ 
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:DECoder<n>:PARallel:EDGE 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


:DECoder<n>:PARallel:EDGE <edge> 
:DECoder<n>:PARallel: EDGE? 


Set or query the edge type of the clock channel when the instrument samples the data 
channel in parallel decoding. 


Name Type Range Default 
<n> Discrete | {1]2} -- 
<edge> Discrete | {RISE]FALL|BOTH} RISE 


If no clock channel is selected (:DECoder<n>:PARallel:CLK), the instrument will sample 
when the channel data jumps. 


The query returns RISE, FALL, or BOTH. 


:DECoder1:PARallel:EDGE BOTH /*Set the oscilloscope to sample data on any edge 
of the clock channel in parallel decoding*/ 


:DECoder1:PARallel:EDGE? /*The query returns BOTH*/ 


:DECoder<n>:PARallel:WIDTh 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


:DECoder<n>:PARallel:WIDTh <wid> 
:DECoder<n>:PARallel:WIDTh? 


Set or query the data width (namely the number of bits of each frame of data) of the 
parallel bus. 


Name Type Range Default 
<n> Discrete | {1|2} - 
<wid> integer | 1 to 16 8 


After setting the data width using this command, send the :DECoder<n>:PARallel:BITX 
and :DECoder<n>:PARallel:SOURce commands to select each bit and set the channel 
source for each bit respectively. 


The query returns an integer between 1 and 16. 


:DECoder1:PARallel:WIDTh 16 
:DECoder1:PARallel: WIDTh? 


/*Set the data width in parallel decoding to 16*/ 
/*The query returns 16*/ 


MSO1000Z/DS1000Z Programming Guide 


RIGOL Chapter 2 Command System 


:DECoder<n>:PARallel:BITX 
Syntax :DECoder<n>:PARallel:BITX <bit> 
:DECoder<n>:PARallel: BITX? 


Description Set or query the data bit that requires a channel source on the parallel bus. 


Parameter Name Type Range Default 
<n> Discrete | {1|2} - 
<bit> Integer | 0 to (data width - 1) 0 


Explanation > Set the data width using the :DECoder<n>:PARallel:WIDTh command. 


> After selecting the desired bit, send the :DECoder<n>:PARallel:sOURce command to 
set the channel source of this bit. 


Return § The query returns the current data bit in integer. 
Format 


Example :DECoder1:PARallel:BITX 2 /*Set the current bit to 2*/ 
:DECoder1:PARallel: BITX? /*The query returns 2*/ 


:DECoder<n>:PARallel:SOURce 
Syntax :DECoder<n>:PARallel:SOURce <src> 
:DECoder<n>:PARallel:SOURce? 


Description Set ro query the channel source of the data bit currently selected. 


Parameter Name Type Range Default 
<n> Discrete | {1|2} = 
{D0|D1|D2|D3|D4]D5|D6|D7|D8| Related to 
<src> Discrete | D9|D10|D11|D12|D13|D14|D15| the bit 
CHANnel1|CHANnel2|CHANnel3|CHANnel4} selected 


Explanation Before sending this command, use the :DECoder<n>:PARallel:BITX command to select 
the desired data bit. 


Return The query returns DO, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D1i1, D12, D13, D14, 
Format D15, CHAN1, CHAN2, CHAN3, or CHAN4. 


Example :DECoder1:PARallel:sOURce CHANnel2 /*Set the channel source of the current bit to 
CH2*/ 
:DECoder1:PARallel: SOURce? /*The query returns CHAN2*/ 


Related :DECoder<n>:PARallel:WIDTh 
Command 
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:DECoder<n>:PARallel:POLarity 
Syntax :DECoder<n>:PARallel:POLarity <pol> 
:DECoder<n>:PARallel:POLarity? 
Description Set ro query the data polarity of parallel decoding. 
Parameter Name Type Range Default 
<n> Discrete | {1]2} - 
<pol> Discrete | {NEGative|POSitive} POSitive 
Explanation > NEGative: HEME. The low level is 1. 
> Positive: MM. The high level is 1. 
Return The query returns NEG or POS. 
Format 
Example :DECoder1:PARallel:POLarity NEGative /*Set the data polarity of parallel decoding to 


negative*/ 


:DECoder1:PARallel:POLarity? /*The query returns NEG*/ 


:DECoder<n>:PARallel:NREJect 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


:DECoder<n>:PARallel:NREJect <bool> 
:DECoder<n>:PARallel: NREJect? 


Turn on or off the noise rejection function of parallel decoding, or query the status of the 
noise rejection function of parallel decoding. 


Name Type Range Default 
<n> Discrete | {1|2} -- 
<bool> Bool {{1]ON}|{0|OFF}} 0|OFF 


> Noise rejection can remove the data without enough duration on the bus to 
eliminate the glitches of the actual circuit. 


> When the noise rejection is turned on, sending the :DECoder<n>:PARallel:NRTime 
command can set the desired rejection time. 


The query returns 1 or 0. 


:DECoder1:PARallel: NREJect ON 
:DECoder1:PARallel: NREJect? 


/*Turn on the noise rejection function*/ 
/*The query returns 1*/ 
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:DECoder<n>:PARallel:NRTime 


Chapter 2 Command System 


Syntax :DECoder<n>:PARallel:NRTime <time> 
:DECoder<n>:PARallel: NRTime? 
Description Set or query the noise rejection time of parallel decoding. The default unit is s. 
Parameter Name Type Range Default 
<n> Discrete | {1|2} 7 
<time> Real 0.00s to 100ms 0.00s 
Explanation Before sending this command, send the :DECoder<n>:PARallel: NREJect command to 
turn on the noise rejection function. 
Return The query returns the noise rejection time in scientific notation. 
Format 
Example :DECoder1:PARallel:NRTime 0.01 /*Set the noise rejection time to 10ms*/ 


:DECoder1:PARallel: NRTime? 


:DECoder<n>:PARallel:CCOMpensation 


/*The query returns 1.000000e-02*/ 


Syntax :DECoder<n>:PARallel:CCOMpensation <comp> 
:DECoder<n>:PARallel:CCOMpensation? 
Description Set or query the clock compensation time of parallel decoding. The default unit is s. 
Parameter Name Type Range Default 
<n> Discrete / {1|2} - 
<comp> Real -100ms to 100ms 0.00s 


Explanation > Setting the compensation time can make fine adjustment of the pahse deviation 
between the clock line and data line. 


> This command is invalid when the CLK channel source is set to OFF 
(:DECoder<n>:PARallel:CLK). 


Return The query returns the compensation time in scientific notation. 
Format 


Example :DECoder1:PARallel:CCOMpensation 0.01 /*Set the compensation time to 10ms*/ 
:DECoder1:PARallel:CCOMpensation? /*The query returns 1.000000e-02*/ 
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:DECoder<n>:PARallel:PLOT 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


:DECoder<n>:PARallel:PLOT <bool> 
:DECoder <n>:PARallel: PLOT? 


Turn on or off the curve function of parallel decoding, or query the status of the curve 
function of parallel decoding. 


Name Type Range Default 
<n> Discrete | {1]2} -- 
<bool> Bool {{1]ON}|{0|OFF}} 0|OFF 


When this function is turned on, the variation trend of the bus data is displayed in vector 
diagram form. 


The query returns 1 or 0. 


:DECoder1:PARallel: PLOT ON /*Turn on the curve function*/ 
:DECoder1:PARallel: PLOT? /*The query returns 1*/ 


MSO1000Z/DS1000Z Programming Guide 2-61 


RIGOL Chapter 2 Command System 


:-DISPlay Commands 


The :DISPlay commands can be used to set the waveform display mode, persistence time, waveform 
intensity, screen grid type and grid brightness. 

Command List: 

@ :DISPlay:CLEar 

@ :DISPlay:DATA? 

@ :DISPlay:TYPE 

@ :DISPlay:GRADing: TIME 
@ :DISPlay:WBRightness 
@ :DISPlay:GRID 

@ :DISPlay:GBRightness 


:DISPlay:CLEar 
Syntax :DISPlay:CLEar 
Description Clear all the waveforms on the screen. 


Explanation > __ Ifthe oscilloscope is in the RUN state, waveform will still be displayed. 


> This command is equivalent to pressing the (CLEAR key at the front panel. Sending 
the :CLEar command can also clear all the waveforms on the screen. 


Related :RUN 
Command 
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:-DISPlay:DATA? 
Syntax :DISPlay:DATA? [<color>,<invert>,<format>] 


Description Read the data stream of the image currently displayed on the screen and set the color, 
invert display, and format of the image acquired. 


Parameter Name Type Range Default 
<color> Bool {ON|OFF} ON 
<invert> Bool {{1]ON}|{0|OFF}} 0|OFF 
<format> Discrete {BMP24|BMP8|PNG|JPEG| TIFF} BMP24 
Explanation > at color of the image; ON denotes color and OFF denotes intensity graded 
color. 


<invert>: the invert function; 1]ON denotes turning on the invert function and 0|OFF 
denotes turning off the invert function. 


> When [<color>,<invert>,<format>] is omitted, by default, the image color 
(:STORage:IMAGe:COLor) and the status of the invert function 
(:STORage:IMAGe: INVERT) currently selected are used and the image format is set 
to BMP24. 


> The command is sent from the PC to the instrument through the VISA interface. The 
instrument responds to the command and directly returns the data stream of the 
image currently displayed to the buffer area of the PC. 


Return The format of the data stream is as follows. 


sii Component | Size (length) | Example Explanation 

TMC Blockheader ::= #NXXXXXX 
is used to describe the length of 
the data stream. Wherein, # is the 
start denoter of the data stream; N 
is less than or equal to 9 and the N 

TMC [1] figures following it denote the 

Blockheader ee DO Tenet length of the data stream in bytes. 
For example, #9001152054; 
wherein, N is 9 and 001152054 
denotes that the data stream 
contains 1152054 bytes of 
effective data. 

Image Data 

(take BMP24 | 800x480x3+54 ie 

Ae ah = 1152054021 BM... Specific image data. 

example) 


Note!#!; N is the width of the data length in the TMC header. For example, the number "9" behind 
"#" in #9001152054. 

Note!2!: The width is 800, the height is 480, the bit depth is 24 bit = 3 byte, 54 is the size of the 
bitmap file header. 


Example 1. Make sure that the buffer is large enough to receive the data stream, otherwise the 
program might be abnormal when reading the data stream. 


2. The returned data stream contains the TMC data header which should be removed to 
make the data stream a standard image data stream. 


3. When the data size is larger than 1 M and the communication speed of the interface 
is not fast enough, you need to set an appropriate timeout time. 


4. The terminator '\n'(OX0A) at the end of the data should be removed. 
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nea 
Basic YO | Line Control | USB Control 


Select or Enter Command Bytes to Read 
| :DISPlay:DATA? v 1024 * 
Write Query Read Read Status Byte Clear 


View mixed ASCII/hexadecimal v 


“a 


5: Write Operation (:DISPlay:DATA?) a 
Return Count: 14 bytes 


6: Read Operation 

Return Count: 1024 bytes 
#9001152054BMN6\,x94\,x11\,x004,x004,x004, x00), x0064,x00',x004,x00 C4, 
x00\,x00\,x00 \x03\x00\x00\,xE0\,x01\,x00\,x00\x01\,x00\x18\x00\, y 


Clear Buffer 


:DISPlay: TYPE 
Syntax :DISPlay:TYPE <type> 
:DISPlay: TYPE? 
Description Set or query the display mode of the waveform on the screen. 
Parameter Name Type Range Default 
<type> Discrete {VECTors| DOTS} VECTors 


Explanation >  VECTors: the sample points are connected by lines. Normally, this mode can provide 
the most vivid waveform to view the steep edge of the waveform (such as square 


waveform). 


> DOTS: display the sample points directly. You can directly view each sample point 
and use the cursor to measure the X and Y values of the sample point. 


Return The query returns VECT or DOTS. 
Format 


Example :DISPlay: TYPE DOTS /*Select dots display mode*/ 
:DISPlay: TYPE? /*The query returns DOTS*/ 
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:DISPlay:GRADing: TIME 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


:DISPlay:GRADing:TIME <time> 
:DISPlay:GRADing: TIME? 

Set or query the persistence time. The default unit is s. 
Type 
Discrete 


Name Default 


MIN 


Range 
{MIN|0.1]0.2]0.5|1]5]10]INFinite} 


<time> 


> MIN: set the persistence time to its minimum to view the waveform changing in high 
refresh rate. 


> Specific Values: set the persistence time to one of the values listed above to observe 
glitch that changes relatively slowly or glitch with low occurrence probability. 


>  INFinite: in this mode, the oscilloscope displays the newly acquired waveform 
without clearing the waveform formerly acquired. It can be used to measure noise 
and jitter as well as capture incidental events. 


The query returns MIN, 0.1, 0.2, 0.5, 1, 5, 10, or INF. 


:DISPlay:GRADing:TIME 0.1 
:DISPlay:GRADing: TIME? 


/*Set the persistence time to 0.1s*/ 
/*The query returns 0.1*/ 


:-DISPlay:WBRightness 


Syntax 


Description 


Parameter 


Return 
Format 


Example 


:DISPlay:WBRightness <time> 
:DISPlay:WBRightness? 

Set or query the waveform brightness. 
Type 
Integer 


Default 
60 


Name Range 


0 to 100 


<time> 


The query returns an integer between 0 and 100. 


:DISPlay:WBRightness 50 
:DISPlay:WBRightness? 


/*Set the waveform brightness to 50%*/ 
/*The query returns 50*/ 
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:DISPlay:GRID 
:DISPlay:GRID <grid> 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


:-DISPlay:GBRightness 


Syntax 


Description 


Parameter 


Return 
Format 


Example 


:DISPlay:GRID? 
Set or query the g 


rid type of screen display. 
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Name 


Type 


Range 


Default 


<grid> 


Discrete 


{FULL|HALF| NONE} 


FULL 


FULL: turn the background grid and coordinate on. 


HALF: turn the background grid off and coordinate on. 


NONE: turn the background grid and coordinate off. 


The query returns FULL, HALF, or NONE. 


:DISPlay:GRID NONE 
:DISPlay:GRID? 


/*Turn the background grid and coordinate off*/ 


/*The query returns NONE*/ 


:DISPlay:GBRightness <brightness> 
:DISPlay:GBRightness? 


Set or query the brightness of the screen grid. 


Name 


Type 


Range 


Default 


<brightness> 


Integer 


0 to 100 


50 


The query returns an integer between 0 and 100. 


:DISPlay:GBRightness 60 
:DISPlay:GBRightness? 


/*Set the brightness of the screen grid to 60%*/ 
/*The query returns 60*/ 
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‘-ETABle Commands 


The :ETABle commands are used to set the parameters related to the decoding event table. 


Command List: 


@ :ETABle<n>:DISP 

@ :ETABle<n>:FORMat 

@ :ETABle<n>:VIEW 

@ :ETABle<n>:COLumn 
@ :ETABle<n>:ROW 

@ :ETABle<n>:SORT 

@ :ETABle<n>:DATA? 
:ETABle<n>:DISP 


Syntax :ETABle<n>:DISP <bool> 
:ETABle<n>:DISP? 


Description Turn on or off the decoding event table, or query the status of the decoding event table. 


Parameter Name Type Range Default 
<n> Discrete | {1|2} = 
<bool> Bool {{1]ON}|{0|OFF}} O|OFF 


Explanation This command is only valid when the decoder is turned on (:DECoder<n>:DISPlay). 


Return The query returns 1 or 0. 


Format 
Example :ETABlei:DISP ON /*Turn on the decoding event table*/ 
:ETABle1:DISP? /*The query returns 1*/ 
‘-ETABle<n>:FORMat 


Syntax :ETABle<n>:FORMat <fmt> 
:ETABle<n>:FORMat? 


Description Set or query the data display format of the event table. 


Parameter Name Type Range Default 
<n> Discrete {1|2} = 
<fmt> Discrete | {HEX|ASCii|DEC} HEX 
Return The query returns HEX, ASC, or DEC. 
Format 
Example :ETABle1:FORMat ASCii /*Set the data display format of the event table to ASCII*/ 
:ETABle1:FORMat? /*The query returns ASC*/ 
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-ETABle<n>:VIEW 


Syntax :ETABle<n>:VIEW <view> 
:ETABle<n>:VIEW? 


Description Set or query the display mode of the event table. 


Parameter Name Type Range Default 
<n> Discrete | {1|2} -- 
<view> Discrete | {PACKage|DETail|PAYLoad} PACKage 


Explanation > PACKage: the time and data are displayed in the event table. 
> DETail: the detailed data of the specified row is displayed in the event table. 
> PAYLoad: all data of the specified column is displayed in the event table. 
Return The query returns PACK, DET, or PAYL. 


Format 
Example :ETABlei: VIEW PAYLoad /*Set the display mode of the event table to PAYLoad*/ 
:ETABle1: VIEW? /*The query returns PAYL*/ 
‘-ETABle<n>:COLumn 


Syntax :ETABle<n>:COLumn <col> 
:ETABle<n>:COLumn? 


Description Set or query the current column of the event table. 


Parameter Name Type Range Default 
<n> Discrete | {1|2} == 
<col> Discrete | {DATA|TX|RX|MISO|MOSI} - 


Explanation > When different decoder is selected (:DECoder<n>:MODE), the range of <col> 
differs. 


Parallel decoding: DATA 
RS232 decoding: TX|RX 
I2C decoding: DATA 

SPI decoding: MISO|MOSI 


> — If the TX or RX channel source in RS232 decoding or the MISO or MOSI channel 
source in SPI decoding is set to OFF, <col> cannot be set to the corresponding 


parameter. 
Return The query returns DATA, TX, RX, MISO, or MOSI. 
Format 
Example :ETABlei:COLumn DATA /*Set the current column to DATA*/ 
:ETABle1:COLumn? /*The query returns DATA*/ 


Related :DECoder<n>:UART:TX 
Commands  .necoder<n>:UART:RX 
:DECoder<n>:SPI:MISO 
:DECoder<n>:SPI:MOSI 
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-ETABle<n>:ROW 
Syntax :ETABle<n>:ROW <row> 
:ETABle<n>:ROW? 

Description Set or query the current row of the event table. 

Parameter Name Type Range Default 
<n> Discrete | {1]2} - 
Zea Integer 1 to the maximum number of rows of the 1 

current event table 
Return The query returns the current row in integer. If the current even table is empty, the 
Format query returns 0. 
Example  :ETABle1:ROW 2 /*Set the current row to 2*/ 
:ETABle1:ROW? /*The query returns 2*/ 
:-ETABle<n>:SORT 
Syntax :ETABle<n>:SORT <sort> 
:ETABle<n>:SORT? 
Description Set or query the display type of the decoding results in the event table. 

Parameter Name Type Range Default 
<n> Discrete | {1|2} - 
<sort> Discrete | {ASCend|DESCend} ASCend 

Explanation > ASCend: the events are displayed in the order in which they occurred. 
> DESCend: the events are displayed in the order reverse to the order in which they 
occurred. 
Return The query returns ASC or DESC. 
Format 
Example :ETABlei:SORT DESCend /*Set the display type of the event table to descend*/ 


:ETABle1:SORT? /*The query returns DESC*/ 
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-ETABle<n>:DATA? 


Syntax :ETABle<n>:DATA? 


Description Read the current event table data. 
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Parameter Name 


Type 


Range 


Default 


<n> 


Discrete 


{1]2} 


Return The query returns the event table data in the format as shown in the figure below. 

Format Wherein, #9000000098 is the TMC data description header followed by the even table 
data and its format is #900000dddd. dddd denotes the number of bytes of the valid 
waveform data following the description header. For example, as shown in the figure 
below, #9000000098 is the TMC data description header, wherein, 98 denotes that there 
are 98 bytes of valid data. The content following 98 is the event table data. 


Example :ETABlei:DATA? 


TMC Data 
Description Header 


20. T5us, 1,, 


198Time, Data, Into, Event Table 


Data 


/*The query returns the data as shown in the figure above*/ 
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‘FUNCtion Commands 


The :FUNCtion commands are used to set the waveform recording and playback parameters. 


Command List: 
:FUNCtion:WRECord:FEND 
:FUNCtion:WRECord:FMAX? 
:FUNCtion: WRECord:FINTerval 
:FUNCtion:WRECord:PROMpt 
:FUNCtion:WRECord:OPERate 
:FUNCtion: WRECord:ENABle 
:FUNCtion: WREPlay:FSTart 
:FUNCtion: WREPlay:FEND 
:FUNCtion: WREPlay:FMAX? 
:FUNCtion: WREPlay:FINTerval 
:FUNCtion:WREPlay: MODE 
:FUNCtion: WREPlay:DIRection 
:FUNCtion: WREPlay:OPERate 
:FUNCtion: WREPlay:FCURrent 


Si 2 A A A A A 


:-FUNCtion:WRECord:FEND 
Syntax :FUNCtion:WRECord:FEND <frame> 
:FUNCtion:WRECord:FEND? 


Description Set or query the end frame of waveform recording. 


Parameter Name Type Range Default 


1 to the maximum number of frames can be 


recorded currently 5008 


<frame> _ | Integer 


Explanation Use the :FUNCtion:WRECord:FMAX? command to query the maximum number of frames 
can be recorded currently. 


Return The query returns the current end frame in integer. 
Format 


Example :FUNCtion:WRECord:FEND 4096 /*Set the end frame to 4096*/ 
:FUNCtion:WRECord:FEND? /*The query returns 4096*/ 
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:FUNCtion:WRECord:FMAX? 


Syntax 
Description 


Explanation 


Return 
Format 


:FUNCtion:WRECord:FMAX? 
Query the maximum number of frames can be recorded currently. 


As the capacity of the waveform memory is fixed, the more the number of points each 
frame of waveform has, the less the number of waveform frames can be recorded. Thus, 
the maximum number of frames can be recorded currently is decided by the memory 
depth currently selected. The less the memory depth, the more the number of waveform 
frames can be recorded. 


The query returns the maximum number of frames can be recorded currently in integer. 


‘-FUNCtion:WRECord:FINTerval 


Syntax 


Description 


Parameter 


Return 
Format 


Example 


:FUNCtion: WRECord:FINTerval <interval> 
:FUNCtion: WRECord:FINTerval? 


Set or query the time interval between frames in waveform recording. The default unit is 
S. 


Name Range 


100ns to 10s 


Default 
100ns 


Type 


Real 


<interval> 


The query returns the time interval currently set in scientific notation. 


:FUNCtion: WRECord:FINTerval 0.001 
:FUNCtion: WRECord:FINTerval? 


/*Set the time interval to ims*/ 
/*The query returns 1.000000e-03*/ 


:FUNCtion:WRECord:PROMpt 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


:FUNCtion:WRECord:PROMpt <bool> 
:FUNCtion: WRECord:PROMpt? 


Turn on or off the sound prompt when the recording finishes, or query the status of the 
sound prompt when the recording finishes. 


Type 


Bool 


Name Range Default 


{{1]ON}|{0|OFF}} 1]ON 


When the sound prompt is turned on, the instrument exerts a sound promt when the 
recording finishes no matter whether the system sound (refer to :SYSTem:BEEPer) is 
turned on or not. 


<bool> 


The query returns 1 or 0. 


:FUNCtion:WRECord:PROMpt 1 /*Turn on the sound prompt when the recording 
finishes*/ 


:FUNCtion: WRECord:PROMpt? /*The query returns 1*/ 
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-FUNCtion:WRECord:OPERate 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


:FUNCtion:WRECord:OPERate <opt> 

:FUNCtion:WRECord:OPERate? 

Start or stop the waveform recording, or query the status of the waveform recording. 
Type 
Discrete 


Name Range Default 


{RUN|STOP} a 


Before sending this command, send the :FUNCtion: WRECord:ENABle command to turn 
on the waveform recording function. Otherwise, this command is invalid. 


<opt> 


The query returns RUN or STOP. 


:FUNCtion: WRECord:OPERate RUN 
:FUNCtion: WRECord:OPERate? 


/*Start the waveform recording*/ 

/*The query returns RUN if the recording is in 
progress and returns STOP if the recording has 
already finished*/ 


:-FUNCtion:WRECord:ENABle 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


:FUNCtion: WRECord:ENABle <bool> 
:FUNCtion: WRECord:ENABle? 


Turn on or off the waveform recording function, or query the status of the waveform 
recording function. 


Type 
Bool 


Name Range Default 


{{1]ON}|{0|OFF}} O|OFF 


> The waveform recording function can only be enabled when the horizontal timebase 
mode is "YT" and the horizontal timebase is lower than 200ms. 


<bool> 


> After turning on the waveform recording function, IRUN/STOP) can be used to start 
or stop the waveform recording. At this point, you can send 
the :FUNCtion: WRECord:OPERate command to start the recording. 


The query returns 1 or 0. 


:FUNCtion: WRECord:ENABle 1 
:FUNCtion: WRECord:ENABle? 


/*Turn on the waveform recording function*/ 
/*The query returns 1*/ 
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:FUNCtion:WREPlay:FSTart 
Syntax :FUNCtion:WREPlay:FSTart <sta> 
:FUNCtion:WREPlay:FSTart? 


Description Set or query the start frame of waveform playback. 


Parameter Name Type Range Default 


<sta> Integer | 1 to the maximum number of frames recorded | 1 


Explanation > Use the :FUNCtion: WRECord:FEND command to set the maximum number of 
frames recorded. 


> The start frame of waveform playback cannot be greater than the end frame of 
waveform playback (:FUNCtion: WREPlay:FEND). 


> You can only set the start frame of waveform playback when a waveform is currently 
recorded. 


> You cannot set the start frame of waveform playback during the waveform recording 
or playback process. 


Return The query returns an integer. 
Format 


Example = :FUNCtion:WREPlay:FSTart 5 /*Set the start frame of waveform playback to 5*/ 
:FUNCtion:WREPlay:FSTart? /*The query returns 5*/ 
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:-FUNCtion:WREPlay:FEND 


Syntax :FUNCtion:WREPlay:FEND <end> 
:FUNCtion:WREPlay:FEND? 


Description Set or query the end frame of waveform playback. 


Parameter Name Type Range Default 
Sands jiateaer 1 to the maximum number of frames | The maximum number 
g recorded of frames recorded 


Explanation > Use the :FUNCtion: WRECord:FEND command to set the maximum number of 
frames recorded. 


> The end frame of waveform playback cannot be lower than the start frame of 
waveform playback (:FUNCtion: WREPlay:FS Tart). 


> You can only set the end frame of waveform playback when a waveform is currently 
recorded. 


> You cannot set the end frame of waveform playback during the waveform recording 
or playback process. 


Return The query returns an integer. 


Format 
Example :FUNCtion:WREPlay:FEND 4096 /*Set the end frame of waveform playback to 
4096*/ 
:FUNCtion: WREPlay:FEND? /*The query returns 4096*/ 


:-FUNCtion:WREPlay:FMAX? 
Syntax :FUNCtion:WREPlay:FMAX? 


Description Query theb maximum number of frames can be played, namely the maximum number of 
frames recorded. 


Explanation Use the :FUNCtion:WRECord:FEND command to set the maximum number of frames 
recorded. 


Return The query returns an integer. 
Format 
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Syntax :FUNCtion:WREPlay:FINTerval <interval> 
:FUNCtion: WREPlay:FINTerval? 
Description Set or query the time interval between frames in waveform playback. The default unit is 
S. 
Parameter Name Type Range Default 
<interval> | Real 100ns to 10s 100ns 
Explanation > Youcan only set the time interval of waveform playback when a waveform is 
currently recorded. 
> You cannot set the time interval of waveform playback during the waveform 
recording or playback process. 
Return The query returns the current time interval in scientific notation. 
Format 
Example :FUNCtion:WREPlay:FINTerval 0.001 /*Set the time interval to ims*/ 


:FUNCtion:WREPlay:FINTerval? /*The query returns 1.000000e-03*/ 


:-FUNCtion:WREPlay:MODE 


Syntax :FUNCtion:WREPlay:MODE <mode> 
:FUNCtion:WREPlay: MODE? 
Description Set or query the waveform playback mode. 
Parameter Name Type Range Default 
<mode>_ | Discrete | {REPeat|SINGle} SINGle 
Explanation > REPeat: cycle playback. Play from the start frame to the end frame and then repeat 
until you stop it manually. 
> SINGle: single playback. Play from the start frame to the end frame and then stop. 
> You can only set the waveform playback mode when a waveform is currently 
recorded. 
> You cannot set the waveform playback mode during the waveform recording or 
playback process. 
Return The query returns REP or SING. 
Format 
Example  :FUNCtion:WREPlay:MODE REPeat /*Set the waveform playback mode to cycle*/ 


:FUNCtion:WREPlay:MODE? /*The query returns REP*/ 
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:-FUNCtion:WREPlay:DIRection 
Syntax :FUNCtion:WREPlay:DIRection <dir> 
:FUNCtion:WREPlay:DIRection? 
Description Set or query the waveform playback direction. 
Parameter Name Type Range Default 
<dir> Discrete | {FORWard|BACKward} FORWard 
Explanation FORWard: positive direction. Play from the start frame to the end frame. 
> BACKward: negative direction. Play from the end frame to the start frame. 
> You can only set the waveform playback direction when a waveform is currently 
recorded. 
> You cannot set the waveform playback direction during the waveform recording or 
playback process. 
Return The query returns FORW or BACK. 
Format 
Example :FUNCtion:WREPlay:DIRection FORWard /*Set the waveform playback direction to 


forward*/ 


:FUNCtion:WREPlay:DIRection? /*The query returns FORW*/ 


:-FUNCtion:WREPlay:OPERate 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


Related 
Command 


:FUNCtion:WREPlay:OPERate <opt> 
:FUNCtion:WREPlay:OPERate? 


Start, pause, or stop the waveform playback, or query the status of the waveform 
playback. 


Default 
STOP 


Name Range 


{PLAY |PAUSe|STOP} 


Type 
Discrete 


<opt> 


This command is only valid when waveform has already been recorded. 
The query returns PLAY, PAUS, or STOP. 


:FUNCtion:WREPlay:OPERate PLAY 
:FUNCtion:WREPlay:OPERate? 


/*Start the waveform playback*/ 
/*The query returns PLAY if the playback is in 
progress and returns STOP if the playback 
finishes*/ 


:FUNCtion: WRECord:OPERate 


MSO1000Z/DS1000Z Programming Guide 


RIGOL 


:FUNCtion:WREPlay:FCURrent 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


:FUNCtion:WREPlay:FCURrent <cur> 


:FUNCtion:WREPlay: FCURrent? 


Set or query the current frame in waveform playback. 


Chapter 2 Command System 


Name Type Range Default 
Senin intaer 1 to the maximum number of The maximum number 
g frames recorded of frames recorded 


> Use the :FUNCtion:WRECord:FEND command to set the maximum number of 


frames recorded. 


> You can only set the current frame of waveform playback when a waveform is 


currently recorded. 


> You cannot set the current frame of waveform playback during the waveform 


recording or playback process. 


The query returns an integer. 


:FUNCtion:WREPlay:FCURrent 300 


:FUNCtion:WREPlay:FCURrent? 


/*Set the current frame in waveform playback to 
300*/ 
/*The query returns 300*/ 
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IEEE488.2 Common Commands 


The IEEE 488.2 standard defines some common commands used for querying the basic information of the 
instrument or executing the basic operations. These commands usually start with "*" and the keyword of 
the command is usually 3-character long. 


Command List: 


mE 
TESe 
*ESR? 
*IDN? 
*OPG 
7a 
*SRE 
*STB? 
ual Eo 
*WAI 


Si A A A A A A A A 


* 
O 
rr 
Ww 


Syntax 
Description 


* ESE 
Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


CLS 


Clear all the event registers and clear the error queue. 


*ESE <value> 


*ESE? 

Set or query the enable register for the standard event status register set. 
Name Type Range Default 
<value> Integer _| Refer to Explanation 0 


The bit 1 and bit 6 of the standard event status register are not used and are always 
treated as 0; therefore, the range of <value> are the decimal numbers corresponding to 
the binary numbers XOXXXXOX (X is 1 or 0). 


The query returns an integer which equals the sum of the weights of all the bits that have 
already been set in the register. 


*ESE 16 
*ESE? 


/*Enable the bit 4 (16 in decimal) of the standard event status register*/ 
/*The query returns 16*/ 
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Syntax *ESR? 

Description Query and clear the event register for the standard event status register. 

Explanation The bit 1 and bit 6 of the standard event status register are not used and are always 
treated as 0. The range of the return value are the decimal numbers corresponding to 
the binary numbers XOXXXXOX (X is 1 or 0). 

Return The query returns an integer which equals the sum of the weights of all the bits in the 
Format _ register. 

*IDN? 
Syntax *IDN? 

Description Query the ID string of the instrument. 

Return The query returns RIGOL TECHNOLOGIES, <model>,<serial number>,<software 
Format version>. 
Whererin, 
<model>: the model number of the instrument. 
<serial number>: the serial number of the instrument. 
<software version>: the software version of the instrument. 
*OPC 
Syntax *OPC 
*OPC? 

Description The *OPC command is used to set the Operation Complete bit (bit 0) in the standard 
event status register to 1 after the current operation is finished. The *OPC? command is 
used to query whether the current operation is finished. 

Return The query returns 1 if the current operation is finished; otherwise, returns 0. 
Format 

*RST 
Syntax *RST 

Description Restore the instrument to the default state. 
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*SRE 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


*STB? 
Syntax 


Description 


Explanation 


Return 
Format 


*TST? 
Syntax 
Description 


Return 
Format 


*WAI 
Syntax 


Description 


Explanation 


*SRE <value> 

*SRE? 

Set or query the enable register for the status byte register set. 
Name Type Range Default 
<value> Integer 0 to 255 0 


The bit 0 and bit 1 of the status byte register are not used and are always treated as 0; 
therefore, the range of <value> are the decimal numbers corresponding to the binary 
numbers XXXXXX00 (X is 1 or 0). 


The query returns an integer which equals the sum of the weights of all the bits that 
have already been set in the register. 


*SRE 16 /*Enable the bit 4 (16 in decimal) of the status byte register*/ 
*SRE? /*The query returns 16*/ 


*STB? 


Query the event register for the status byte register. The value of the status byte register 
is set to 0 after this command is executed. 


The bit 0 and bit 1 of the status byte register are not used and are always treated as 0. 
The query returns the decimal numbers corresponding to the binary numbers XOXXXX0X 
(X is 1 or 0). 


The query returns an integer which equals the sum of the weights of all the bits in the 
register. 


¥*TST? 
Perform a self-test and then return the seilf-test results. 


The query returns a decimal integer. 


*WAI 
Wait for the operation to finish. 


The subsequent command can only be carried out after the current command has been 
executed. 
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The :LA commands are used to perform the related operations on the digital channels. These commands 
are only applicable to MSO1000Z and DS1000Z Plus with the MSO upgrade option. 


Command List: 

:LA:ACTive 
:LA:AUTosort 
:LA:DIGital<n>:DISPlay 


:LA:DIGital<n>:LABel 
:LA:DISPlay 
:LA:POD<n>:DISPlay 
:LA:POD<n>:THReshold 
:LA:SIZE 

:LA:STATe 
:LA:TCALibrate 


Si A A A 2 A A A A A 


:LA:ACTive 


Syntax = :LA:ACTive {<digital>|<group>|NONE} 


:LA:ACTive? 


:LA:DIGital<n>:POSition 


Description Set or query the current active channel or channel group. 


Parameter Name Type Range Default 
- , {D0|D1|D2|D3]D4|D5|D6|D7| o 
<digital> | Discrete | \8/p9/p10|D11|D12|D13|D14|D15} 
<group> | Discrete | {GROUP1|GROUP2|GROUP3|GROUP4} -- 


Explanation > <digital> is used to select any of channels DO to D15. The channel label and 
waveform corresponding to the channel selected are displayed in red. 


>  <group> is used to select any of user-defined channel groups (GROUP1 to 
GROUP4), All the channel labels and waveforms of the channel group selected are 
displayed in red. 


> When NONE is sent, no channel/channel group will be selected. 


> Only channels or user-defined channel groups currently turned on can be selected. 
Please refer to the :LA:DIGital<n>:DISPlay or :LA:DISPlay command to turn on the 


desired channel or channel group. 


Return The query returns the current active channel (DO, D1,...or D15), the current active 
Format channel group (GROUP1, GROUP2, GROUP3, or GROUP4) or NONE. 


Example — :LA:ACTive D3 


:LA:ACTive? 


/*Set the current active channel to D3*/ 
/*The query returns D3*/ 
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:LA:AUTosort 
Syntax :LA:AUTosort <n> 


Description Set the auto ordering mode of the waveforms of the channels turned on on the screen. 


Parameter Name Type Range Default 


<n> Discrete | {0|1} 1 


Explanation > <n> = 0: waveforms on the screen are D15 to DO from top to bottom 


>  <n> = 1: waveforms on the screen are DO to D15 from top to bottom 


:-LA:DIGital<n>:DISPlay 
Syntax :LA:DIGital<n>:DISPlay <bool> 
:LA:DIGital<n>:DISPlay? 


Description Turn on or off the specified digital channel, or query the status of the specified digital 


channel. 
Parameter Name Type Range Default 
<n> Integer | Oto 15 “= 
DO to D7: 1]ON 
<bool> Bool {{1]ON}|{0|OFF}} D8 to D15: nice 


Explanation You can set the channels currently turned on as the active channel using the :LA:ACTive 
command. 


Return The query returns 1 or 0. 
Format 


Example — :LA:DIGital3:DISPlay ON /*Turn D3 on*/ 
:LA:DIGital3:DISPlay? /*The query returns 1*/ 
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Syntax = :LA:DIGital<n>:POSition <position> 
:LA:DIGital<n>:POSition? 
Description Set or query the display position of the specified digital channel waveform on the screen. 
Parameter Name Type | Range Default 
<n> Integer | 0 to 15 == 
When the waveform display mode is SMALI: 0 to 15 
Yngetisas | anteaee When the waveform display mode is LARGe: 0 to 7 | _ 
P g For the waveform display mode, refer to 
the :LA:SIZE command 
Explanation > <position> (0 to 15 or 0 to 7) denotes the display position of the waveform on the 
screen. When the waveform display mode is SMALI, 16 waveforms can be displayed 
on the screen marked as 0 to 15 from top to bottom. When the waveform display 
mode is LARGe, 8 waveforms can be displayed on the screen marked as 0 to 7 from 
top to bottom. 
> The setting command is only valid when the specified digital channel is turned on. 
Return The query returns an integer from 0 to 15 or from 0 to 7. 
Format 
Example — :LA:DIGital1:POSition 3 /*Set the display position of D1 to 3*/ 


:LA:DIGital1:POSition? /*The query returns 3*/ 


:LA:DIGital<n>:LABel 


Syntax :LA:DIGital<n>:LABel <label> 
:LA:DIGital<n>:LABel? 
Description Set or query the label of the specified digital channel. 
Parameter Name Type | Range Default 
<n> Integer | 0 to 15 = 
It can include English uppercase letters (A to Z) 
ASCII 
<label> etn and numbers (0 to 9). - 
9 | tt cannot exceed 4 characters. 
Return The query returns the label of the specified digital channel in ASCII string. If the 
Format = specified channel has no label, the query returns "No Label". 
Example — :LA:DIGital0:_LABel ACK /*Set the label of DO to ACK*/ 


:LA:DIGital0:LABel? /*The query returns ACK*/ 
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:-LA:DISPlay 


Syntax 


:LA:DISPlay {<digital>|<group>|<pod>},<bool> 


:LA:DISPlay? {<digital>|<group>|<pod>} 


Description Turn on or off the specified digital channel, user-defined channel group or default 
channel group, or query the status of the specified digital channel, user-defined channel 
group or default channel group. 


Parameter 


Explanation > 


Name Type Range Default 


{D0|D1|D2|D3]D4|D5|D6|D7| 


<digital> | Discrete me 


D8|D9|D10|D11|D12|D13|D14|D15} 


<group> | Discrete {GROUP1|GROUP2|GROUP3|GROUP4} -- 
<pod> Discrete {POD1|POD2} - 
<bool> Bool {{1]ON}|{0]OFF}} - 


> 


When any of channels DO to D7 is turned on, the CH4 function is disabled 
automatically. When channels DO to D7 are all turned off, the CH4 function is 
enabled automatically. 

When any of channels D8 to D15 is turned on, the CH3 function is disabled 
automatically. When channels D8 to D15 are all turned off, the CH4 function is 
enabled automatically. 


<group> denotes the user-defined channel groups. Users can set the digital 
channels included in the specified user-defined channel group. 
Note: A channel can only be added to an unique user-defined channel group. 


<pod> denotes the default channel groups: POD1 (DO to D7) and POD2 (D8 to 
D15). 


The channels and user-defined channel groups currently turned on can be selected 
as the active channel or channel group using the :LA:ACTive command. 


Return § The query returns 1 or 0. 


Format 


Example 


:LA:DISPlay POD1,ON /*Turn POD1 (DO to D7) on*/ 
:LA:DISPlay? POD1 /*The query returns 1*/ 
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:LA:POD<n>:DISPlay 
Syntax :LA:POD<n>:DISPlay <bool> 
:LA:POD<n>:DISPlay? 


Description Turn on or off the specified default channel group, or query the status of the specified 
default channel group. 


Parameter Name_ | Type Range Default 
<n> Integer 1 to2 == 
<bool> | Bool {{1]ON}|{0|OFF}} = 


Explanation > _ There are 2 default channel groups: POD1 (DO to D7) and POD2 (D8 to D15). 


> When POD1 is turned on, the CH4 function is disabled automatically. When POD1 is 
turned off, the CH4 function is enabled automatically. 
When POD2 is turned on, the CH3 function is disabled automatically. When POD2 is 
turned off, the CH3 function is enabled automatically. 


Return The query returns 1 or 0. 
Format 


Example :LA:POD1:DISPlay 1 /*Turn POD1 (DO to D7) on*/ 
:LA:POD1:DISPlay? /*The query returns 1*/ 


:LA:POD<n>:THReshold 
Syntax :LA:POD<n>:THReshold <thre> 
:LA:POD<n>:THReshold? 


Description Set or query the threshold of the specified channel group. The default unit is V. 


Parameter Name _ | Type Range Default 
<n> Integer 1to2 -- 
<thre> | Real -15.0V to +15.0V 1.40V 


Explanation There are 2 default channel groups: POD1 (DO to D7) and POD2 (D8 to D15). 


Return The query returns the current threshold of the specified channel group in scientific 
Format notation. 


Example = :LA:POD1:THReshold 3.3 /*Set the threshold of POD1 (DO to D7) to 3.3V*/ 
:LA:POD1:THReshold? /*The query returns 3.300000e+00*/ 
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:-LA:SIZE 
Syntax :LA:SIZE <size> 
:LA:SIZE? 
Description Set or query the display size of the waveforms of the channels turned on on the screen. 
Parameter Name Type Range Default 
<size> Discrete | {SMALI|LARGe} SMALI 


Explanation > SMALI: up to 16 waveforms can be displayed on the screen (0 to 15 from top to 
bottom). 


>  LARGe: up to 8 waveforms can be displayed on the screen (0 to 7 from top to 
bottom). 


> The LARGe display mode is only available when the number of channels currently 
turned on is no more than 8. 


Return The query returns SMAL or LARG. 


Format 
Example — :LA:SIZE SMALI /*Set the waveform display size to small*/ 
:LA:SIZE? /*The query returns SMAL*/ 
Related :LA:DIGital<n>:POSition 
Command 
:LA:STATe 
Syntax :LA:STATe <bool> 
:LA:STATe? 
Description Turn on or off the LA function, or query the status of the LA function. 
Parameter Name Type Range Default 
<bool> Bool {{1]ON}|{0|OFF}} 0|OFF 
Return The query returns 1 or 0. 
Format 
Example :LA:STATe ON /*Turn on the LA function*/ 


:LA:STATe? /*The query returns 1*/ 
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:LA:TCALibrate 
Syntax :LA:TCALibrate <tcal> 
:LA:TCALibrate? 
Description Set or query the delay calibration time of the digital channels. The default unit is s. 
Parameter Name Type Range Default 
<tcal> Real -100ns to 100ns 0.00s 
Explanation > When using the oscilloscope for actual measurement, the transmission delay of the 


probe cable may cause relatively larger error (zero offset). Zero offset is defined as 
the offset of the crossing point of the waveform and threshold level line relative to 
the trigger position. Users can set a delay time to calibrate the zero offset of the 


corresponding channel. 


> You can only set <tcal> to a specified value at certain step. If the parameter sent is 
not one of the specified values, the specified value nearest to the value sent will be 
used. The step of this parameter differs in different horizontal timebase (set by 
the :TIMebase[:MAIN]:SCALe command), as shown in the table below. 


Horizontal Timebase 


Delay Calibration Time Step 


5ns 100ps 
10ns 200ps 
20ns 400ps 
50ns ins 
100ns 2ns 
200ns 4ns 
500ns 10ns 
lus to 10us 20ns 


Note: When the horizontal timebase is equal to or greater than 10us, the delay 
calibration time cannot be adjusted. 


Return The query returns the delay calibration time in scientifc notation. 


Format 


Example 


:LA:TCALibrate 0.00000002 
:LA:TCALibrate? 


/*Set the delay calibration time to 20ns*/ 
/*The query returns 2.000000e-08*/ 
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:-MATH Commands 


The :MATH commands are used to set the operations between the waveforms of multiple channels. 


Note: 
v The operations include the following types: 

Algebraic Operations: A+B, A-B, AxB, A/B 

Spectrum Operation: FFT 

Logic Operations: A&&B, A||B, A“*B, !A 

Functional Operations: Intg, Diff, Sqrt, Lg, Ln, Exp, Abs 

Filter: Low Pass Filter, High Pass Filter, Band Pass Filter, Band Stop Filter 
Compound Operations: Combination of two operations (inner and outer) 


v For logic operations, the waveform data to be operated is compared with the preset threshold and is 
converted to 0 or 1. Thus, the result will also be 0 or 1. 


¥ Fora relatively complicated operation, you can split it into inner and outer layer operations (namely 
compound operation) according to your need. The inner layer operation (fx) can only be algebraic 
operation and the outer layer operation can only be algebraic operation or functional operation. 


When the outer layer operation is algeriac operation, at least one of source A and source B of the outer 
layer operation should be set to FX. 

When the outer layer operation is functional operation, the source of the outer layer operation can only 
be set to FX. 


Note: For the inner layer operation (fx), you can send 

the :MATH:OPTion:FX:SOURce1, :MATH:OPTion:FX:SOURce2, and :MATH:OPTion:FX:OPERator commands to set 
the sources and operator of the inner layer operation. For the outer layer operation, you can send 

the :MATH:SOURcei, :MATH:SOURce2, and :MATH:OPERatorcommands to set the sources and operator of the 
outer layer operation. 


Command List: 
:MATH:DISPlay 
:MATH:OPERator 
:MATH:SOURce1 
:MATH:SOURce2 
:MATH:LSOUrce1 
:MATH:LSOUrce2 
:MATH:SCALe 
:MATH:OFFSet 
:MATH:INVert 
:MATH:RESet 
:MATH:FFT:SOQURce 
:MATH: FFT: WINDow 
:MATH:FFT:SPLit 
:MATH:FFT:UNIT 
:MATH:FFT:HSCale 
:MATH: FFT: HCENter 
:MATH:FFT: MODE 


. i A A A A A 2 A A A A A A A 
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:MATH:FiLTer: TYPE 


:MATH:FILTer:W1 


:MATH:FILTer:W2 
:MATH:OPTion:STARt 


:MATH:OPTion:END 


:MATH:OPTion:INVert 
:MATH:OPTion:SENSitivity 
:MATH:OPTion:DIStance 


:MATH:OPTion:ASCale 
:MATH:OPTion:THReshold1 
:MATH:OPTion: THReshold2 


:MATH:OPTion:FX:SOURce1 


, i 2 2 2 A A A A A A A A A 


:MATH:OPTion:FX:SOURce2 
:MATH:OPTion:FX:OPERator 


:MATH:DISPlay 


Syntax 


Description 


Parameter 


Return 
Format 


Example 


:MATH:DISPlay <bool> 
:MATH:DISPlay? 


Enable or disable the math operation function or query the math operation status. 


Name Type Range Default 


<bool> | Bool {{1]ON}|{0|OFF}} O|OFF 


The query returns 1 or 0. 


:MATH:DISPlay ON /*Enable the math operation function*/ 
:MATH:DISPlay? /*The query returns 1*/ 


:-MATH:OPERator 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


:MATH:OPERator <opt> 
:MATH:OPERator? 


Set or query the operator of the math operation. 


Name Type Range Default 


{ADD]|SUBTract| MULTiply | DIVision|AND|OR|XOR| 
<opt> Discrete | NOT|FFT|INTG|DIFF|SQRT|LOG|LN|EXP|ABS| ADD 
FILTer} 


When the parameter in :MATH:SOURcei and/or :MATH:SOURce2 is FX, this command is 
used to set the operator of the outer layer operation of compound operation. The range of 
<opt> is {ADD|SUBTract|MULTiply|DIVision|INTG| DIFF|SQRT|LOG|LN|EXP|ABS}. 


The query returns ADD, SUBT, MULT, DIV, AND, OR, XOR, NOT, FFT, INTG, DIFF, SQRT, 
LOG, LN, EXP, ABS, or FILT. 


:MATH:OPERator INTG /*Set the operator of the math operation to integration*/ 
:MATH:OPERator? /*The query returns INTG*/ 
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:-MATH:SOURCe1 
Syntax :MATH:SOURcel <src> 
:MATH:SOURce1? 


Description Set or query the source or source A of algebraic operation/functional operation/the outer 
layer operation of compound operation. 


Parameter Name Type Range Default 
<src> Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4|FX}_| CHANneli 


Explanation > _ For algebraic operations, this command is used to set source A. 
For functional operations, only this command is used to set the source. 


For compound operations, this command is used to set source A of the outer layer 
operation when the outer layer operation is algeriac operation and the range of 
<src> is {CHANnel1|CHANnel2|CHANnel3|CHANnel4}; this command is used to set 
the source of the outer layer operation when the outer layer operation is functional 
operation and <src> can only be FX. 


Note: When the outer layer operation of compound operation is algebraic operation, at least 
one of source A and source B of the outer layer operation should be set to FX. 


> When "FX" is selected, you can send 
the :MATH:OPTion:FX:SOURce1, :MATH:OPTion:FX:SOURce2, 
and :MATH:OPTion:FX:OPERator commands to set the sources and operator of the 
inner layer operation. 


Return The query returns CHAN1, CHAN2, CHAN3, CHAN4, or FX. 
Format 


Example :MATH:SOURce1 CHANnel3 /*Set source A of algebraic operation to CH3*/ 
:MATH:SOURce1? /*The query returns CHAN3*/ 
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:MATH:SOURCe2 
Syntax :MATH:SOURCce2 <src> 
:MATH:SOURce2? 


Description Set or query source B of algebraic operation/the outer layer operation of compound 
operation. 


Parameter Name Type Range Default 
<src> Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4|FX} | CHANnel1 


Explanation > This command is only applicable to algebraic operations (requiring two sources) and 
compound operations whose outer layer operations are algebraic operations. 


> When the outlayer operation of compound operation is algebraic operation, this 
command is used to set source B of the outer layer operation. 


Note: When the outer layer operation of compound operation is algebraic operation, at least 
one of source A and source B of the outer layer operation should be set to FX. 


> When "FX" is selected, you can send 
the :MATH:OPTion:FX:SOURce1, :MATH:OPTion:FX:SOURce2, 
and :MATH:OPTion:FX:OPERator commands to set the sources and operator of the 
inner layer operation. 


Return The query returns CHAN1, CHAN2, CHAN3, CHAN4, or FX. 


Format 
Example :MATH:SOURce2 CHANnel3 /*Set source B of algebraic operation to CH3*/ 
:MATH:SOURce2? /*The query returns CHAN3*/ 
:MATH:LSOUrcel 


Syntax :MATH:LSOUrcel <src> 
:MATH:LSOUrcel? 


Description Set or query source A of logic operation. 


Parameter Name Type Range Default 
{D0|D1|D2|D3|D4|D5|D6|D7|D8| 
<src> Discrete | D9]D10]D11]D12|D13|D14|D15| DO 
CHANnel1|CHANnel2|CHANnel3|CHANnel4} 


Explanation The logic operations include A&&B, A||B, A*B, and !A. 


Return The query returns DO, D1, D2, D3, D4, D5, D6, D7, D8, DI, D10, D1i1, D12, D13, D14, 
Format D15, CHANi, CHAN2, CHAN3, or CHAN4. 


Example :MATH:LSOUrcel D3 /*Set source A of logic operation to D3*/ 
:MATH:LSOUrce1? /*The query returns D3*/ 
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:>=MATH:LSOUrce2 


Syntax :MATH:LSOUrce2 <src> 
:MATH:LSOUrce2? 
Description Set or query source B of logic operation. 
Parameter Name Type Range Default 
{D0|D1|D2|D3|D4]D5|D6|D7|D8| 
<src> Discrete D9|D10|D11|D12|D13|D1i4|D15| D1 
CHANnel1| CHANnel2|CHANnel3|CHANnel4} 
Explanation > _ The logic operations include A&&B, A]|B, A*B, and !A. 
> This command is only applicable to logic operations that require two signal sources 
and is used to set source B. 
Return The query returns DO, Di, D2, D3, D4, D5, D6, D7, D8, D9, D10, Di1, D12, D13, D14, D15, 
Format CHAN1, CHAN2, CHAN3, or CHAN4. 
Example :MATH:LSOUrce2 D4 _—/*Set source B of logic operation to D4*/ 
:MATH:LSOUrce2? /*The query returns D4*/ 
-MATH:SCALe 
Syntax :MATH:SCALe <scale> 
:MATH:SCALe? 
Description Set or query the vertical scale of the operation result. The unit depends on the operator 
currently selected and the unit of the source. 
Parameter Name Type Range Default 
<scale> | Real The max range is from ip to 5T (in 1-2-5 step) | 1.00V 
Explanation The range of the vertical scale is related to the operator currently selected and the vertical 
scale of the source channel. For the integration (intg) and differential (diff) operations, it 
is also related to the current horizontal timebase. 
Return The query returns the vertical scale of the operation result in scientific notation. 
Format 
Example :MATH:SCALe 2 /*Set the vertical scale to 2V*/ 
:MATH:SCALe? /*The query returns 2.000000e+00*/ 
Related :CHANnel<n>:SCALe 
Commands 


:CHANnel<n>:UNITs 
:MATH:OPERator 
:TIMebase[:MAIN]:SCALe 
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:=MATH:OFFSet 


Syntax 


:MATH:OFFSet <offs> 
:MATH:OFFSet? 


Description Set or query the vertical offset of the operation result. The unit depends on the operator 
currently selected and the unit of the source. 
Parameter Name Type Range Default 
Related to the vertical scale of the operation result 
Range: (-1000 x MathVerticalScale) to (1000 x 
sos es MathVerticalScale) ony 
Step: MathVerticalScale/50 
Explanation MathVerticalScale is the vertical scale of the operation result and can be set by 
the :MATH:SCALe command. 
Return The query returns the vertical offset of the operation result in scientific notation. 
Format 
Example :MATH:OFFSet 8  /*Set the vertical offset to 8V*/ 
:MATH:OFFSet?  /*The query returns 8.000000e+00*/ 
Related :MATH:OPERator 
Commands -cHannel<n>:UNITs 
:MATH:INVert 
Syntax :MATH:INVert <bool> 
:MATH:INVert? 
Description Enable or disable the inverted display mode of the operation result, or query the inverted 
display mode status of the operation result. 
Parameter Name Type Range Default 
<bool> | Bool {{1|ON}|{0|OFF}} 0|OFF 


Explanation 


Return 
Format 


Example 


Related 
Command 


> — This command is invalid for the FFT operation. 
> This command has the same function as the :MATH:OPTion:INVert command. 


The query returns 1 or 0. 


:MATH:INVert ON 
:MATH:INVert? 


:MATH:OPERator 


/*Enable the inverted display mode*/ 
/*The query returns 1*/ 
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-MATH:RESet 
Syntax :MATH:RESet 


Description Sending this command, the instrument adjusts the vertical scale of the operation result to 
the most proper value according to the current operator and the horizontal timebase of 


the source. 
Related :MATH:OPERator 
Commands waTH:SCALe 


:TIMebase[:MAIN]:SCALe 


:-MATH:FFT:SOURCce 
Syntax :MATH:FFT:SOURce <src> 
:MATH:FFT:SOURce? 


Description Set or query the source of FFT operation/filter. 


Parameter Name Type Range Default 
<src> Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4}_ | CHANnel1 
Return The query returns CHAN1, CHAN2, CHAN3, or CHAN4. 
Format 
Example :MATH:FFT:SOURce CHANnel3 /* Set the source of FFT operation to CH3*/ 
:MATH:FFT:SOURce? /* The query returns CHAN3*/ 
Related :MATH:OPERator 
Command 
-MATH:FFT:WINDow 


Syntax :MATH:FFT:WINDow <wnd> 
:MATH:FFT:WINDow? 


Description Set or query the window function of the FFT operation. 


Parameter Name Type Range Default 


{RECTangle|BLACkman|HANNing|HAMMing| 
FLATtop|TRIangle} 


Explanation > Spectral leakage can be considerably decreased when a window function is used. 


<wnd> Discrete RECTangle 


> — Different window functions are applicable to measure different waveforms. You need 
to select the window function according to waveform to be measured and its 
characteristics. 


Return The query returns RECT, BLAC, HANN, HAMM, FLAT, or TRI. 
Format 


Example :MATH:FFT:WINDow BLACkman /*Set the window function of the FFT operation to 
blackman*/ 
:MATH:FFT:WINDow? /* The query returns BLACK*/ 


Related :MATH:OPERator 
Command 
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=MATH:FFT:SPLit 
Syntax :MATH:FFT:SPLit <bool> 
:MATH:FFT:SPLit? 
Description Enable or disable the half-screen display mode of the FFT operation, or query the status 
of the half display mode of the FFT operation. 
Parameter Name Type Range Default 
<bool> Bool {{1|ON}|{0|OFF}} 1JON 
Explanation > _ Enable the half-screen display mode: the source channel and the FFT operation 
results are displayed separately. The time domain and frequency domain signals are 
displayed clearly. 
> Disable the half-screen display mode (full-screen display mode): the source channel 
and the FFT operation results are displayed in the same window to view the 
frequency spectrum more clearly and to perform more precise measurement. 
Return The query returns 1 or 0. 
Format 
Example :MATH:FFT:SPLit OFF /*Disable the half-screen display mode*/ 
:MATH:FFT:SPLit? /*The query returns 0*/ 
Related :MATH:OPERator 
Command 
:MATH:FFT:UNIT 
Syntax :MATH:FFT:UNIT <unit> 
:MATH:FFT:UNIT ? 
Description Set or query the vertical unit of the FFT operation result. 
Parameter Name Type Range Default 
<unit> Discrete {VRMS|DB} DB 
Return The query returns VRMS or DB. 
Format 
Example  :MATH:FFT:UNIT VRMS /*Set the vertical unit of the FFT operation result to Vrms*/ 
:MATH:FFT:UNIT ? /*The query returns VRMS*/ 
Related :MATH:OPERator 
Command 
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:MATH:FFT:HSCale 


Syntax 


:MATH:FFT:HSCale <hsc> 
:MATH:FFT:HSCale? 


Description Set or query the horizontal scale of the FFT operation result. The default unit is Hz. 


Parameter 


Explanation 


Return 
Format 


Example 


Related 
Commands 


Name Type Range Default 
<hsc> Real Refer to Explanation 5MHz 
>  <hsc> can be set to 1/1000, 1/400, 1/200, 1/100, 1/40, or 1/20 of the FFT sample 
rate. 


> When the FFT mode is set to TRACe, FFT sample rate equals to screen sample rate, 
that is, 100/horizontal timebase. 
When the FFT mode is set to MEMory, FFT sample rate equals to memory sample 
rate (:ACQuire:SRATe?). 


> You can view the detailed information of the frequency spectrum by reducing the 
horizontal scale. 


The query returns the horizontal scale in scientific notation. 


:MATH:FFT:HSCale 500000 /*Set the horizontal scale of the FFT operation result to 
500kHz*/ 
:MATH:FFT:HSCale? /*The query returns 5.000000e+05*/ 


:MATH:OPERator 
:MATH:FFT: MODE 


:TIMebase[:MAIN]:SCALe 
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:MATH:FFT:HCENter 
Syntax :MATH:FFT:HCENter <cent> 
:MATH:FFT:HCENter? 
Description Set or query the center frequency of the FFT operation result, namely the frequency 
relative to the horizontal center of the screen. The default unit is Hz. 
Parameter Name Type Range Default 
<cent> Real Refer to Explanation 5MHz 


> When the FFT mode is set to TRACe, the range of <cent> is from 0 to (0.4 x FFT 
sample rate). Wherein, FFT sample rate equals to screen sample rate, that is, 
100/horizontal timebase. 
When the FFT mode is set to MEMory, the range of <cent> is from 0 to (0.5 x FFT 


sample rate). Wherein, FFT sample rate equals to memory sample rate 
(:ACQuire:SRATe?). 
> Step = Horizontal Scale of the FFT operation result/50. 


Return The query returns the current center frequency in scientific notation. 
Format 
Example :MATH:FFT:HCENter 10000000 /*Set the center frequency of the FFT operation result 
to 10MHz*/ 
:MATH:FFT:HCENter? /*The query returns 1.000000e+07*/ 
Related :MATH:OPERator 
Commands aTH:FFT:MODE 
:TIMebase[:MAIN]:SCALe 
:MATH:FFT:HSCale 
:MATH:FFT:MODE 
Syntax :MATH:FFT:MODE <mode> 
:MATH:FFT:MODE? 
Description Set or query the FFT mode. 
Parameter Name Type Range Default 
<mode>_ | Discrete {TRACe]MEMory} TRACe 


Explanation 


Return 
Format 


Example 


> TRACe: denotes that the data source of the FFT operation is the data of the 
waveform displayed on the screen. 


> MEMory: denotes that the data source of the FFT operation is the data of the 
waveform in the memory. 


The query returns TRAC or MEM. 


:MATH:FFT:MODE TRACe 


:MATH:FFT:MODE? 


/*Set the FFT mode to TRACe*/ 
/* The query returns TRAC*/ 
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-MATH:FILTer: TYPE 
Syntax :MATH:FILTer: TYPE <type> 
:MATH:FILTer: TYPE? 
Description Set or query the filter type. 
Parameter Name Type Range Default 
<type> Discrete {LPASs|HPASs|BPASs|BSTOP} LPASs 
Explanation > MSO1000Z/DS1000Z provides 4 types of filters (Low Pass Filter, High Pass Filter, 
Band Pass Filter, and Band Stop Filter). Setting the bandwidth can filter the 
specified frequencies. You can send the :MATH:FFT:SOURce command to set or 
query the source of the filter. 
>  LPASs: low pass, which indicates that only the signals whose frequencies are lower 
than the current cutoff frequency (@c1) can pass the filter. 
> HPASs: high pass, which indicates that only the signals whose frequencies are 
greater than the current cutoff frequency (@c1) can pass the filter. 
>  BPASs: band pass, which indicates that only the signals whose frequencies are 
greater than current cutoff frequency 1 (wel) and lower than current cutoff 
frequency 2 (wc2) can pass the filter. 
Note: Cutoff frequency 1 (wc1) must be lower than cutoff frequency 2 (wc2). 
> BSTOP: band stop, which indicates that only the signals whose frequencies are 
lower than current cutoff frequency 1 (@c1) or greater than current cutoff 
frequency 2 (wc2) can pass the filter. 
Note: Cutoff frequency 1 (wc1) must be lower than cutoff frequency 2 (@c2). 
Return The query returns LPAS, HPAS, BPAS, or BSTOP. 
Format 
Example :MATH:FILTer:TYPE LPASs /*Set the filter type to low pass*/ 
:MATH:FILTer: TYPE? /*The query returns LPAS*/ 
Related :MATH:FiILTer:W1 
Commands 


:MATH:FILTer:W2 
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:MATH:FILTer:W1 
Syntax :MATH:FILTer:W1 <freqi> 
:MATH:FILTer:W1? 


Description Set or query the cutoff frequency (@wc1) of the low pass/high pass filter or cutoff 
frequency 1 (@c1) of the band pass/band stop filter. The default unit is Hz. 


Parameter Name Type _ | Range Default 


Related to the filter type 
LPASs|BPASs|BSTOP: 0.005 x screen 


<freqi> | Real Refer to Explanation sample rate 
HPASs: 0.1 x screen sample rate 
Explanation > When the type of the filter is set to LPASs (low pass) or HPASs (high pass), you 


need to set one cutoff frequency (wc1). At this time, the range of <freqi> is from 
(0.005 x screen sample rate) to (0.1 x screen sample rate), with a step of (0.005 x 
screen sample rate). Wherein, Screen Sample Rate = 100/Horizontal Timebase. 


> When the type of the filter is set to BPASs (band pass) or BSTOP (band stop), you 
need to set two cutoff frequencies. Send this command to set cutoff frequency 1 
(@c1); and send the :MATH:FILTer:W2 command to set cutoff frequency 2 (wc2). 
At this time, the range of <freqi> is from (0.005 x screen sample rate) to (0.095 x 
screen sample rate), with a step of (0.005 x screen sample rate). Wherein, Screen 
Sample Rate = 100/Horizontal Timebase. 
Note: Cutoff frequency 1 (wc1) must be lower than cutoff frequency 2 (wc2). 


Return The query returns the current cutoff frequency or cutoff frequency 1 in scientific 
Format notation. 


Example  :MATH:FILTer:W1i 1000000 /*Set the cutoff frequency of the low pass filter to 
1MHz*/ 
:MATH:FILTer:W1? /*The query returns 1.000000e+06*/ 


Related = :MATH:FILTer:TYPE 
Commands timebase[:MAIN]:SCALe 
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-MATH:FILTer:W2 
Syntax :MATH:FILTer:W2 <freq2> 
:MATH:FILTer:W2? 
Description Set or query the cutoff frequency 2 (wc2) of the band pass/band stop filter. The default 
unit is Hz. 
Parameter Name Type Range Default 
<freq2> Real Refer to Explanation 0.1 x screen sample rate 
Explanation When the type of the filter is set to BPASs (band pass) or BSTOP (band stop), you need 
to set two cutoff frequencies. Send the :MATH:FILTer:W1 command to set cutoff 
frequency 1 (wei); and send this command to set cutoff frequency 2 (w@c2). At this time, 
the range of <freq2> is from (0.01 x screen sample rate) to (0.1 x screen sample rate), 
with a step of (0.005 x screen sample rate). Wherein, Screen Sample Rate = 
100/Horizontal Timebase. 
Note: Cutoff frequency 2 (wc2) must be greater than cutoff frequency 1 (wc1). 
Return The query returns current cutoff frequency 2 in scientific notation. 
Format 
Example :MATH:FILTer:W2 1500000 /*Set cutoff frequency 2 of the band pass filter to 
1.5MHz*/ 
:MATH:FILTer:W2? /*The query returns 1.500000e+06*/ 
Related = :MATH:FILTer: TYPE 
Commands 


:TIMebase[:MAIN]:SCALe 


:MATH:OPTion:STARt 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


Related 
Command 


:MATH:OPTion:STARt <sta> 

:MATH:OPTion:STARt? 

Set or query the start point of the waveform math operation. 
Type 
Integer 


Name Range Default 


<sta> 0 to (End point currently set - 1) 0 


> This command is invalid for the FFT operation. Sending this command will modify the 
start points of all the operations (except FFT). 


> The source selected is equally divided into 1200 parts horizontally, in which the 
leftmost is 0 and the rightmost is 1199. 


The query returns an integer. 


:MATH:OPTion:STARt 50 
:MATH:OPTion:STARt? 


:MATH:OPTion:END 


/*Set the waveform start point to 50*/ 
/*The query returns 50*/ 


MSO1000Z/DS1000Z Programming Guide 


2-101 


RIGOL 


Chapter 2 Command System 


:MATH:OPTion:END 
Syntax :MATH:OPTion:END <end> 
:MATH:OPTion: END? 
Description Set or query the end point of the waveform math operation. 
Parameter Name Type Range Default 
<end> Discrete (Start point currently set+1) to 1199 1199 
Explanation > This command is invalid for the FFT operation. Sending this command will modify the 
end points of all the operations (except FFT). 
> The source selected is equally divided into 1200 parts horizontally, in which the 
leftmost is 0 and the rightmost is 1199. 
Return The query returns an integer. 
Format 
Example :MATH:OPTion:END 200 /*Set the waveform end point to 200*/ 
:MATH:OPTion:END? /*The query returns 200*/ 
Related :MATH:OPTion:STARt 
Command 


:-MATH:OPTion:INVert 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


:MATH:OPTion:INVert <bool> 
:MATH:OPTion:INVert? 


Enable or disable the inverted display mode of the operation result, or query the inverted 
display mode status of the operation result. 


Name Range Default 


{{1]ON}|{O|OFF}} O|OFF 


> This command is invalid for the FFT operation. Sending this command will modify 
the inverted display mode status of all the operations (except FFT). 


Type 


Bool 


<bool> 


> This command has the same function as the :MATH:INVert command. 


The query returns 1 or 0. 


:MATH:OPTion:INVert ON 
:MATH:OPTion:INVert? 


/*Enable the inverted display mode*/ 
/*The query returns 1*/ 
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=MATH:OPTion:SENSitivity 
Syntax :MATH:OPTion:SENSitivity <sens> 
:MATH:OPTion:SENSitivity? 


Description Set or query the sensitivity of the logic operation. The default unit is div (namely the 
current vertical scale). 


Parameter Name Type Range Default 


<sens> | Real 0 to 0.96, the step is 0.08 0 


Explanation This command is only applicable to logic operations (A&&B, A||B, A*B, and !A). 


Return The query returns the current sensitivity in scientific notation. 
Format 


Example :MATH:OPTion:SENSitivity 0.24 /*Set the sensitivity of the logic operation to 0.24div*/ 
:MATH:OPTion:SENSitivity? /*The query returns 2.400000e-01*/ 


Related :CHANnel<n>:SCALe 


Commands waTH-OPERator 


-MATH:OPTion:DIStance 


Syntax :MATH:OPTion:DIStance <dist> 
:MATH:OPTion:DIStance? 


Description Set or query the smoothing window width of differential operation (diff). 


Parameter Name Type Range Default 


<dist> Integer 3 to 201 3 


Explanation This command is only applicable to differential operation (diff). 


Return The query returns an integer between 3 and 201. 


Format 
Example :MATH:OPTion:DIStance 25 /*Set the smoothing window width to 25*/ 
:MATH:OPTion:DIStance? /*The query returns 25*/ 
Related :MATH:OPERator 
Command 
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:MATH:OPTion:ASCale 
Syntax :MATH:OPTion:ASCale <bool> 
:MATH:OPTion:ASCale? 


Description Enable or disable the auto scale setting of the operation result or query the status of the 
auto scale setting. 


Parameter Name Type Range Default 


<bool> Bool {{1]ON}|{0|OFF}} 0|OFF 


Explanation > When the auto scale is enabled, the instrument will automatically calculate the 
vertical scale range according to the current operator, the vertical scale and the 
horizontal timebase. If the current scale is out of the range, it will adjust the vertical 
scale to the best value automatically. 


> Sending this command will modify the auto scale status of all the operation results. 


Return The query returns 1 or 0. 
Format 


Example :MATH:OPTion:ASCale ON /*Enable the auto scale setting */ 
:MATH:OPTion:ASCale? /*The query returns 1*/ 


:MATH:OPTion:THReshold1 


Syntax :MATH:OPTion:THResholdi <thre> 
:MATH:OPTion: THReshold1? 


Description Set or query the threshold level of source A in logic operations. The default unit is V. 


Parameter Name Type Range Default 


(-4 x VerticalScale - VerticalOffset) to 


(4 x VerticalScale - VerticalOffset) sada 


<thre> Real 


Explanation > This command is only applicable to A&&B, A||B, A*B, and !A logic operations of 
which source A is an analog channel. 


>  VerticalScale refers to the vertical scale of source A 
VeticalOffset refers to the vertical offset of source A 
The step is VerticalScale/50 


Return The query returns the threshold level in scientific notation. 
Format 


Example :MATH:OPTion:THResholdi 0.8 /*Set the the threshold level of source A in logic 
operations to 800mV*/ 
:MATH:OPTion:THReshold1? /*The query returns 8.000000e-01*/ 


Related :CHANnel<n>:SCALe 
Commands :CHANnel<n>:OFFSet 
:MATH:LSOUrcel 
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=MATH:OPTion:THReshold2 
Syntax :MATH:OPTion:THReshold2 <thre> 
:MATH:OPTion: THReshold2? 


Description Set or query the threshold level of source B in logic operations. The default unit is V. 


Parameter Name Type Range Default 


(-4 x VerticalScale - VerticalOffset) to 
(4 x VerticalScale - VerticalOffset) 


<thre> Real 0.00V 


Explanation > This command is only applicable to A&&B, A]|B, and A“*B logic operations of which 
source B is an analog channel. 


>  VerticalScale refers to the vertical scale of source B 
VeticalOffset refers to the vertical offset of source B 
The step is VerticalScale/50 


Return The query returns the threshold level in scientific notation. 
Format 


Example :MATH:OPTion:THReshold2 0.5 /*Set the threshold level of source B in logic 
operations to 0.5V*/ 
:MATH:OPTion:THReshold2? /*The query returns 5.000000e-01*/ 


Related :CHANnel<n>:SCALe 
Commands :CHANnel<n>:OFFSet 
:MATH:LSOUrce2 


>=MATH:OPTion:FX:SOURce1 
Syntax :MATH:OPTion:FX:SOURcel <src> 
:MATH:OPTion:FX:SOURce1? 


Description Set or query source A of the inner layer operation of compound operation. 


Parameter Name Type Range Default 
<src> Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4} CHANnel1 


Return The query returns CHAN1, CHAN2, CHAN3, or CHAN4. 
Format 


Example :MATH:OPTion:FX:SOURce1 CHANnel1 /*Set source A of the inner layer operation of 
compound operation to CH1*/ 
:MATH:OPTion:FX:SOURce1? /*The query returns CHAN1*/ 
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:MATH:OPTion:FX:SOURce2 
Syntax :MATH:OPTion:FX:SOURce2 <src> 
:MATH:OPTion:FX:SOURce2? 


Description Set or query source B of the inner layer operation of compound operation. 


Parameter Name Type Range Default 


<src> Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4} CHANnel1 


Return The query returns CHAN1, CHAN2, CHAN3, or CHAN4. 
Format 


Example :MATH:OPTion:FX:SOURce2 CHANnel1 /*Set source B of the inner layer operation of 


compound operation to CH1*/ 
:MATH:OPTion:FX:SOURce2? /*The query returns CHAN1*/ 


:-MATH:OPTion:FX:OPERator 
Syntax :MATH:OPTion:FX:OPERator <op> 
:MATH:OPTion:FX:OPERator? 


Description Set or query the operator of the inner layer operation of compound operation. 


Parameter Name Type Range Default 


<op> Discrete {ADD|SUBTract|MULTiply|DIVision} ADD 


Return The query returns ADD, SUBT, MULT, or DIV. 
Format 


Example :MATH:OPTion:FX:OPERator ADD /*Set the operator of the inner layer operation of 


compound operation to addition*/ 
:MATH:OPTion:FX:OPERator? /*The query returns ADD*/ 
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-MASK Commands 


The :MASK commands are used to set and query the pass/fail test parameters. 


Command List: 
:MASK:ENABle 
:MASK:SOURce 
:MASK:OPERate 
:MASK:MDISplay 
:MASK:SOOutput 
:MASK:OUTPut 
:MASK:X 
:MASK:Y 
:MASK:CREate 
:MASK:PASSed? 
:MASK:FAILed? 
:MASK:TOTal? 
:MASK:RESet 


i A 2 A A A A 


:MASK:ENABle 
Syntax :MASK:ENABle <bool> 
:MASK:ENABle? 


Description Enable or disable the pass/fail test or query the status of the past/fail test. 


Parameter Name Type Range Default 


<bool> Bool {{1]ON}|{0|OFF}} 0|OFF 


Explanation The pass/fail test is invalid in the following conditions: the horizontal timebase is XY or 
ROLL, in the slow sweep mode (namely when the horizontal timebase is YT, the 
horizontal timebase is set to 200ms/div or slower) as well as during waveform record. 


Return The query returns 1 or 0. 
Format 


Example :MASK:ENABle ON /*Enable the pass/fail test*/ 
:MASK:ENABle? /*The query returns 1*/ 
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:MASK:SOURCce 
Syntax :MASK:SOURce <source> 
:MASK:SOURce? 
Description Set or query the source of the pass/fail test. 
Parameter Name Type Range Default 
<source> | Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4}_ | CHANnel1 
Explanation Only channels enabled can be selected as the source. You can sent 
the :CHANnel<n>:DISPlay command to enable the desired channel. 
Return The query returns CHAN1, CHAN2, CHAN3, or CHAN4. 
Format 
Example :MASK:SOURce CHANnel2 /*Set the source of the pass/fail test to CH2*/ 
:MASK:SOURce? /*The query returns CHAN2*/ 
-MASK:OPERate 
Syntax :MASK:OPERate <oper> 
:MASK:OPERate? 
Description Run or stop the pass/fail test, or query the status of the pass/fail test. 
Parameter Name Type Range Default 
<oper> Discrete {RUN|STOP} STOP 
Explanation Before executing this command, you need to send the :MASK:ENABle command to enable 
the pass/fail test. 
Return The query returns RUN or STOP. 
Format 
Example :MASK:OPERate RUN /*Run the pass/fail test*/ 
:MASK:OPERate? /*The query returns RUN*/ 
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:MASK:MDISplay 


Syntax 


:MASK:MDISplay <bool> 
:MASK:MDISplay? 


Description Enable or disable the statistic information when the pass/fail test is enabled, or query the 
status of the statistic information. 
Parameter Name Type Range Default 
<bool> Bool {{1]ON}|{0|OFF}} O|OFF 
Explanation > Before executing this command, you need to send the :MASK:ENABle command to 
enable the pass/fail test. 
> When the statistic information is on, the test results as shown in the figure below will 
be displayed at the upper right corner of the screen. 
Total = 94 wfs 
> You can sent the :MASK:PASSed?, :MASK:FAILed?, and :MASK:TOTal? commands to 
query the test results. 
Return The query returns 1 or 0. 
Format 
Example :MASK:MDISplay ON /*Enable the statistic information*/ 
:MASK:MDISplay? /*The query returns 1*/ 
-MASK:SOOutput 
Syntax :MASK:SOOutput <bool> 
:MASK:SOOutput? 
Description Turn the "Stop on Fail" function on or off, or query the status of the "Stop on Fail" 
function. 
Parameter Name Type Range Default 
<bool> Bool {{1]ON}|{0|OFF}} O|OFF 
Explanation > ON: when failed waveforms are detected, the oscilloscope will stop the test and enter 
the "STOP" state. At this point, the results of the test remain the same on the screen 
(if the display is turned on) and the [Trigger Out] connector (if enabled) at the rear 
panel outputs a single pulse. 
> OFF: the oscilloscope will continue with the test even though failed waveforms are 
detected. The test results on the screen will update continuously and the [Trigger 
Out] connector at the rear panel outputs a pulse each time a failed waveform is 
detected. 
Return The query returns 1 or 0. 
Format 
Example :MASK:SOOutput ON /*Turn the "Stop on Fail" function on*/ 
:MASK:SOOutput? /*The query returns 1*/ 
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:MASK:OUTPut 
Syntax :MASK:OUTPut <bool> 
:MASK:OUTPut? 
Description Enable or disable the sound prompt when failed waveforms are detected, or query the 
status of the sound prompt. 
Parameter Name Type Range Default 
<bool> | Bool {{1]ON}|{0|OFF}} O|OFF 
Explanation > OFF: when failed waveforms are detected, there are display and output but the 
beeper does not sound. 
> ON: when failed waveforms are detected, there are display and output and the 
beeper sounds (not related to the on/off state of the sound). 
Return The query returns 1 or 0. 
Format 
Example :MASK:OUTPut ON /*Enable the sound prompt*/ 
:MASK:OUTPut? /*The query returns 1*/ 
:MASK:X 
Syntax ‘:MASK:X <x> 
:MASK:X? 
Description Set or query the horizontal adjustment parameter in the pass/fail test mask. The default 
unit is div. 
Parameter Name Type Range Default 
<x> Real 0.02 to 4, the step is 0.02 within the range 0.02 
Return The query returns the horizontal adjustment parameter in scientific notation. 
Format 
Example :MASK:X0.28  /*Set the horizontal adjustment parameter to 0.28div*/ 
:MASK:X? /*The query returns 2.800000e-01*/ 
:MASK:Y 
Syntax :MASK:Y <y> 
:MASK:Y? 
Description Set or query the vertical adjustment parameter in the pass/fail test mask. The default unit 
is div. 
Parameter Name Type Range Default 
<y> Real 0.04 to 5.12, the step is 0.04 within the range | 0.96 
Return The query returns the vertical adjustment parameter in scientific notation. 
Format 
Example :MASK:Y 0.36 /*Set the vertical adjustment parameter to 0.36div*/ 
:MASK:Y? /*The query returns 3.600000e-01*/ 
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:-MASK:CREate 
Syntax :MASK:CREate 


Description Create the pass/fail test mask using the current horizontal adjustment parameter and 
vertical adjustment parameter. 


Explanation This command is valid only when the pass/fail test is enabled (:MASK:ENABle) and is not 
in the run state (:MASK:OPERate). 


Related :MASK:X 
Commands “MASK:Y 


-MASK:PASSed? 
Syntax :MASK:PASSed? 
Description Query the number of passed frames in the pass/fail test. 


Return § The query returns an integer. 
Format 


:MASK:FAILed? 
Syntax :MASK:FAILed? 
Description Query the number of failed frames in the pass/fail test. 


Return The query returns an integer. 
Format 


:MASK:TOTal? 
Syntax :MASK:TOTal? 
Description Query the total number of frames in the pass/fail test. 


Return The query returns an integer. 
Format 


:-MASK:RESet 
Syntax :MASK:RESet 


Description Reset the numbers of passed frames and failed frames as well as the total number of 
frames in the pass/fail test to 0. 


Related :MASK:PASSed? 
Commands wask:FAlLed? 
:MASK:TOTal? 
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:-MEASure Commands 


MSO1000Z/DS1000Z supports the auto measurement of the following 37 waveform parameters and 
provides the statistic function for the measurement results. In additional, you can use the frequency 
counter to make more precise frequency measurement. The :MEASure commands are used to set and 
query the measurement parameters. 


1. 


2. Count Values 


Time Parameters 


Period: 


Frequency: 
Rise Time: 


Fall Time: 
+Width: 
-Width: 
+Duty: 
-Duty: 


tVmax: 
tVmin: 


+Pulses: 


Rise Time Fall Time 
| 


Defined as the time between the threshold middle points of two consecutive, 
like-polarity edges. 

Defined as the reciprocal of period. 

The time for the signal amplitude to rise from the lower limit to the upper limit of the 
threshod. 

The time for the signal amplitude to fall from the upper limit to the lower limit of the 
threshod. 

The time difference between the threshold middle point of a rising edge to that of the 
next falling edge of the pulse. 

The time difference between the threshold middle point of a falling edge to that of the 
next rising edge of the pulse. 

The ratio of the positive pulse width to the period. 

The ratio of the negative pulse width to the period. 

The time corresponding to the waveform maximum value (Vmax). 

The time corresponding to the waveform minimum value (Vmin). 


| l 
! 
| 

| ! Threshold 

| ; Upper Limit 
| | 

| Threshold 
Middle Point 
| 

| Threshold 
Lower Limit 


The number of positive pulses that rise from below the threshold lower limit to above 
the threshold upper limit. 
+Pulses=n 
Threshold 
Upper Limit 


Threshold 
Lower Limit 
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-Pulses: The number of negative pulses that fall from above the threshold upper limit to 
below the threshold lower limit. 
-Pulses=n 


Threshold 
Upper Limit 


_, Threshold 
Lower Limit 


+Edges: The number of rising edges that rise from below the threshold lower limit to above 
the threshold upper limit. 
+Edges=n 
Threshold 
Upper Limit 


Threshold 
Lower Limit 


-Edges: The number of falling edges that fall from above the threshold upper limit to below 
the threshold lower limit. 
-Edges=n 
Threshold 
Upper Limit 


__ Threshold 
Lower Limit 


3. Delay and Phase 

Delay 41--2: The time difference between the rising edges of source 1 and source 2. Negative 
delay indicates that the selected rising edge of source 1 occurred after the selected 
rising edge of source 2. 

Delay *1--2: The time difference between the falling edges of source 1 and source 2. Negative 
delay indicates that the selected falling edge of source 1 occurred after the selected 
falling edge of source 2. 

Phase * 1-2: Phase difference calculated according to "Delay + 1--2" and the period of source 
1, expressed in degree. The calculation formula is as shown below. 

Phase 1-2: Phase difference calculated according to "Delay = 1-2" and the period of source 
1, expressed in degree.The calculation formula is as shown below. 


Phase = Dada x 360° 
Period 


Wherein, Phase denotes "Phase + 1-2" or "Phase € 1—2", Delay denotes "Delay + 4-2" 
or "Delay 1-2" and Period| denotes the period of source 1. 


' Period ' 
a el | 
i} i} 


Source 1 | | | | | | 


Source 2 
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4. Voltage Parameters 
Vmax: The voltage value from the highest point of the waveform to the GND. 


Vmin: 


The voltage value from the lowest point of the waveform to the GND. 


Vpp: The voltage value from the highest point to the lowest point of the waveform. 
Vtop: The voltage value from the flat top of the waveform to the GND. 
Vbase: The voltage value from the flat base of the waveform to the GND. 
Vamp: The voltage value from the top of the waveform to the base of the waveform. 
Vupper: The actual voltage value corresponding to the threshold maximum value. 
Vmid: The actual voltage value corresponding to the threshold middle value. 
Vlower: The actual voltage value corresponding to the threshold minimum value. 
Vavg: The arithmetic average value on the whole waveform or on the gating area. The 

calculation formula is as follows: 

DH 
Average = 
n 

Wherein, x, is the measurement result of the ith point, n is the number of points 

being measured. 
Vrms: The root mean square value on the whole waveform or the gating area. The calculation 


formula is as follows: 


Wherein, x, is the measurement result of the ith point, n is the number of points 
being measured. 


Overshoot: The ratio of the difference between the maximum value and top value of the waveform 


to the amplitude value. 


Preshoot: The ratio of the difference between the minimum value and base value of the waveform 


to the amplitude value. 


Per.Vrms: — The root mean square value within a period. For the calculation formula, please refer to 


"Vrms". 


Variance: The average of the sum of the squares for the difference between the amplitude value 


of each waveform point and the waveform average value on the whole waveform or on 
the gating area. The variance reflects the fluctuation degree of the waveform. The 
calculation formula is as follows: 
> (Vamp(i) - Average) 
Variance = —_________ 
n 
Wherein, Vamp(i) is the amplitude of the ith point, Average is the average value of 


the waveform, n_ is the number of points being measured. 


Overshoot 


Vmax 


Vupper 


Vpp Vmid 


Vlower 


Vmin 


Preshoot 
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5. 


Command List: 


fe HHH HHH HHH HO 


Other Parameters 


+Rate: 


-Rate: 


Area: 


Period 
Area: 


Divide the difference of the upper value and lower value on the rising edge by the 
corresponding time. 

Divide the difference of the lower value and upper value on the falling edge by the 
corresponding time. 

The area of the whole waveform within the screen and the unit is voltage-second. The 
area meadured above the zero reference (namely the vertical offset) is positive and 
the area measured below the zero reference is negative. The area measured is the 
algebraic sum of the area of the whole waveform within the screen. 

The area of the first period of the waveform on the screen and the unit is 
voltage-second. The area above the zero reference (namely the vertical offset) is 
positive and the area below the zero reference is negative. The area measured is the 
algeraic sum of the area of the waveform within the whole period. 


:MEASure:SOURce 
:MEASure:COUNter:SOURce 
:MEASure:COUNter:VALue? 


:MEASure:CLEar 
:MEASure:RECover 
:MEASure:ADISplay 


:MEASure:AMSource 


:MEASure:SETup:MAX 
:MEASure:SETup:MID 


:MEASure:SETup:MIN 


:MEASure:SETup:PSA 


:MEASure:SETup:PSB 
:MEASure:SETup:DSA 


:MEASure:SETup:DSB 


:MEASure:STATistic: DISPlay 
:MEASure:STATistic: MODE 


:MEASure:STATistic: RESet 


:MEASure:STATistic: ITEM 
:MEASure:ITEM 


MSO1000Z/DS1000Z Programming Guide 2-115 


RIGOL 


Chapter 2 Command System 


:MEASure:SOURCe 


:MEASure:SOURce <sour> 
:MEASure:SOURce? 


Description Set or query the source of the current measurement parameter. 


Syntax 


Parameter 


Explanation > 


Name Type Range Default 


{D0|D1|D2|D3|D4|D5|D6|D7|D8| 


<sour> Discrete | D9|D10|D11|D12]D13|D14|D15| CHANnel1 


CHANnel1|CHANnel2|CHANnel3|CHANnel4|MATH} 


Analog channels CH1 to CH4 can be selected no matter wether they are currently 
turned on. Note: When any of channels DO to D7 is turned on, CH4 cannot be 
selected; when any of channels D8 to D15 is selected, CH3 cannnot be selected. 


For digital channels DO to D15, only channels currently turned on can be selected. 


This command is used to set the source for the measurement parameters (except 
delay and phase). The delay and phase measurements requires two sources which 
can be set by the :MEASure:SETup:DSA 


and :MEASure:SETup:DSB, :MEASure:SETup:PSA and :MEASure:SETup:PSB 
commands respectively. 


Return The query returns DO, D1, D2, D3, D4, D5, D6, D7, D8, DI, D10, D1i1, D12, D13, D14, 
Format D15, CHANi, CHAN2, CHAN3, CHAN4, or MATH. 


:MEASure:SOURce CHANnel2 /*Set the parameter measurement source to CH2*/ 
:MEASure:SOURce? /*The query returns CHAN2*/ 


Related :MEASure:ITEM 


Example 


Command 


:MEASure:COUNter:SOURCe 


:MEASure:COUNter:SOURce <sour> 
:MEASure:COUNter: SOURce? 


Description Set or query the source of the frequency counter, or disable the frequency counter. 


Syntax 


Parameter 


Explanation 


Name Type Range Default 


{D0|D1|D2|D3|D4|D5|D6|D7|D8| 


<sour> | Discrete | D9|D10|D11|D12|D13|D14|D15| OFF 


CHANnel1 | CHANnel2|CHANnel3|CHANnel4|OFF} 


> 


> 


Analog channels CH1 to CH4 can be selected no matter wether they are currently 
turned on. Note: When any of channels DO to D7 is turned on, CH4 cannot be 
selected; when any of channels D8 to D15 is selected, CH3 cannnot be selected. 


For digital channels DO to D15, only channels currently turned on can be selected. 


Return The query returns DO, Di, D2, D3, D4, D5, D6, D7, D8, DI, D10, D11, D12, D13, D14, 
Format D15, CHANi1, CHAN2, CHAN3, CHAN4, or OFF. 


Example :MEASure:COUNter:SOURce CHANnel2 /*Set the source of the frequency counter to 
CH2*/ 
:MEASure:COUNter:SOURce? /*The query returns CHAN2*/ 
Related :MEASure:COUNter:VALue? 
Command 
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‘MEASure:COUNter:VALue? 


Syntax 


:MEASure:COUNter:VALue? 
Description Query the measurement result of the frequency counter. The default unit is Hz. 


RIGOL 


Return The query returns the measurement result in scientific notation. If the frequency counter 
is disabled, 0.0000000e+00 will be returned. 


/*The query returns 1.000004e+03*/ 


Format 
Example :MEASure:COUNter:VALue? 
Related :MEASure:COUNter:SOURce 
Command 
:-MEASure:CLEar 
Syntax :MEASure:CLEar <item> 


Description Clear one or all of the last five measurement items enabled. 


Parameter 


Name Type 


Range 


Default 


<item> Discrete 


{ITEM1 |ITEM2|ITEM3|ITEM4 |ITEM5|ALL} 


Explanation > You can use the :MEASure:ITEM command to enable the desired parameters of the 
37 waveform parameters. Note that the last five parameters are determined 

according to the order in which you turned them on and they will not change as you 
delete one or more measurement items. 


> You can send the :MEASure:RECover command to recover the item(s) when a certain 
item or all the items are cleared. 


/*Clear ITEM1*/ 


Example :MEASure:CLEar ITEM1 
:-MEASure:RECover 
Syntax :MEASure:RECover <item> 


Description Recover the measurement item which has been cleared. 


Parameter 


Name Type 


Range 


Default 


<item> Discrete 


{ITEM1 |ITEM2|ITEM3|ITEM4 |ITEM5|ALL} 


Explanation > You can use the :MEASure:ITEM command to enable the desired parameters of the 
37 waveform parameters. Note that the last five parameters are determined 

according to the order in which you turned them on and they will not change as you 
delete one or more measurement items. 


> You can send the :MEASure:CLEar command to clear the items again after one or all 
of the measurement items are recovered. 
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:MEASure:ADISplay 
:MEASure:ADISplay <bool> 


Syntax 


:MEASure:ADISplay? 


Chapter 2 Command System 


Description Enable or disable the all measurement function, or query the status of the all 
measurement function. 


Parameter 


Explanation 


Name 


Type 


Range 


Default 


<bool> 


Bool 


{{1]ON}|{0|OFF}} 


O|OFF 


> The all measurement function can measure the following 29 parameters of the 
source at the same time: 
Voltage Parameters: Vmax, Vmin, Vpp, Vtop, Vbase, Vamp, Vupper, Vmid, Vlower, 
Vavg, Vrms, Overshoot, Preshoot, Period Vrms, and Variance 
Time Parameters: Period, Frequency, Rise Time, Fall Time, +Width, -Width, +Duty, 
-Duty, tVmax, and tVmin 
Other Parameters: +Rate, -Rate, Area, and Period Area. 


> The all measurement function can measure CH1, CH2, CH3, CH4, and the MATH 
channel at the same time. You can send the :MEASure:AMSource command to set 
the source of the all measurement function. 


Return The query returns 1 or 0. 


Format 
Example :MEASure:ADISplay ON 
:MEASure:ADISplay? 
:MEASure:AMSource 
Syntax 


/*Enable the all measurement function*/ 
/*The query returns 1*/ 


:MEASure:AMSource <src>[,<src>[,<src>[,<src>]]] 


:MEASure:AMSource? 


Description Set or query the source(s) of the all measurement function. 


Parameter 


Name 


Type 


Range 


Default 


<src> 


Discrete 


{CHANnel1|CHANnel2|CHANnel3|CHANnel4|MATH} 


CHANnel1 


Return The query returns CHAN1, CHAN2, CHAN3, CHAN4, or MATH. Multiple sources are 
Format separated by commas. 


Example :MEASure:AMSource CHANneli,CHANnel3 /*Set the sources of the all measurement 
function to CH1 and CH3*/ 
:MEASure:AMSource? /*The query returns CHAN1,CHAN3*/ 
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-MEASure:SETup:MAX 
Syntax :MEASure:SETup:MAX <value> 
:MEASure:SETup:MAX? 


Description Set or query the upper limit of the threshold (expressed in the percentage of amplitude) in 
time, delay, and phase measurements. 


Parameter Name Type Range Default 


<value> | Integer 7 to 95 90 


Explanation > The upper limit, middle point, and lower limit of the threshold (expressed in the 
percentage of amplitude) are used to define the time, delay, and phase parameters. 
Setting these values will affect the measurement results of the time, delay, and phase 
parameters. 


> Setting the upper limit lower than the middle point will automatically reduce the 
middle point to keep it lower than the upper limit. 


Return The query returns an integer between 7 and 95. 
Format 


Example :MEASure:SETup:MAX 95 /*Set the upper limit of the threshold to 95%*/ 
:MEASure:SETup:MAX? /*The query returns 95*/ 


Related :MEASure:SETup:MID 
Sonne :MEASure:SETup:MIN 
:MEASure:ITEM 


:-MEASure:SETup:MID 
Syntax :MEASure:SETup:MID <value> 
:MEASure:SETup:MID? 


Description Set or query the middle point of the threshold (expressed in the percentage of amplitude) 
in time, delay, and phase measurements. 


Parameter Name Type Range Default 


<value>_ | Integer 6 to 94 50 


Explanation > The upper limit, middle point, and lower limit of the threshold (expressed in the 
percentage of amplitude) are used to define the time, delay, and phase parameters. 
Setting these values will affect the measurement results of the time, delay, and phase 
parameters. 


> The middle point must be lower than the upper limit and greater than the lower limit. 


Return The query returns an integer between 6 and 94. 
Format 


Example :MEASure:SETup:MID 89 /*Set the middle point of the threshold to 89%*/ 
:MEASure:SETup:MID? /*The query returns 89*/ 


Related :MEASure:SETup:MAX 
Commands . yeasure:SETup:MIN 
:MEASure:ITEM 
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:MEASure:SETup:MIN 
Syntax :MEASure:SETup:MIN <value> 
:MEASure:SETup:MIN? 


Description Set or query the lower limit of the threshold (expressed in the percentage of amplitude) in 
time, delay, and phase measurements. 


Parameter Name Type Range Default 


<value> Integer 5 to 93 10 


Explanation > The upper limit, middle point, and lower limit of the threshold (expressed in the 
percentage of amplitude) are used to define the time, delay, and phase parameters. 
Setting these values will affect the measurement results of the time, delay, and phase 
parameters. 


> Setting the lower limit greater than the middle point will automatically increase the 
middle point to keep it greater than the lower limit. 


Return The query returns an integer between 5 and 93. 
Format 


Example :MEASure:SETup:MIN 53 /*Set the lower limit of the threshold to 53%*/ 
:MEASure:SETup:MIN? /*The query returns 53*/ 


Related :MEASure:SETup:MAX 
Commands  yeasure:SETup:MID 
:MEASure:ITEM 


:MEASure:SETup:PSA 


Syntax :MEASure:SETup:PSA <source> 
:MEASure:SETup:PSA? 


Description Set or query source A of Phase + 1—2 and Phase t 1-2 measurements. 


Parameter Name Type Range Default 
{D0|D1|D2|D3]D4|D5|D6|D7|D8| 
<source> | Discrete D9|D10]D11]D12|D13|D14]D15| CHANnelt1 
CHANnel1|CHANnel2|CHANnel3|CHANnel4} 


Return The query returns DO, Di, D2, D3, D4, D5, D6, D7, D8, DI, D10, D11, D12, D13, D14, 
Format D15, CHAN1, CHAN2, CHAN3, or CHAN4. 


Example :MEASure:SETup:PSA CHANnel1 /*Set source A of phase measurement to CH1*/ 
:MEASure:SETup:PSA? /*The query returns CHAN1*/ 


Related :MEASure:ITEM 
Command 
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:-MEASure:SETup:PSB 
:MEASure:SETup:PSB <source> 


Syntax 


Description Set or query source B of Phase ¥ 1—2 and Phase t 1—2 measurements. 


Parameter 


:MEASure:SETup:PSB? 


RIGOL 


Name Type Range Default 
{D0|D1|D2|D3|D4|D5|D6|D7|D8| 
<source> | Discrete | D9|D10|D11|D12|D13|D14|D15| CHANnel2 


CHANnel1|CHANnel2|CHANnel3| CHANnel4} 


Return The query returns DO, D1, D2, D3, D4, D5, D6, D7, D8, DI, D10, D11, D12, D13, D14, 
Format D15, CHANi, CHAN2, CHAN3, or CHAN4. 


Example 


Related 
Command 


:MEASure:SETup:PSB CHANnel2 


:MEASure:SETup:PSB? 


:MEASure:ITEM 


:-MEASure:SETup:DSA 
:MEASure:SETup:DSA <source> 


Syntax 


Description Set or query source A of Delay ¥ 1-2 and Delay € 1-2 measurements. 


Parameter 


:MEASure:SETup:DSA? 


/*The query returns CHAN2*/ 


/*Set source B of phase measurement to CH2*/ 


Name Type Range Default 
{D0|D1|D2|D3|D4|D5|D6|D7|D8| 
<source> | Discrete | D9|D10|D11|D12|D13|D14|D15| CHANnel1 


CHANnel1|CHANnel2|CHANnel3|CHANnel4} 


Return The query returns DO, Di, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, 
Format D15, CHANi, CHAN2, CHAN3, or CHAN4. 


Example 


Related 
Command 


:MEASure:SETup:DSA CHANnel1 


:MEASure:SETup:DSA? 
:MEASure:ITEM 


/*The query returns CHAN1*/ 


/*Set source A of delay measurement to CH1*/ 
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:MEASure:SETup:DSB 


Syntax :MEASure:SETup:DSB <source> 
:MEASure:SETup:DSB? 


Description Set or query source B of Delay ¥ 1-2 and Delay € 12 measurements. 


Parameter Name Type Range Default 
{D0|D1|D2|D3|D4|D5|D6|D7|D8| 
<source> | Discrete D9|D10|D11|D12|D13|D14|D15| CHANnel2 
CHANnel1|CHANnel2|CHANnel3|CHANnel4} 


Return The query returns DO, Di, D2, D3, D4, D5, D6, D7, D8, DI, D10, D11, D12, D13, D14, 
Format D15, CHANi, CHAN2, CHAN3, or CHAN4. 


Example :MEASure:SETup:DSB CHANnel2 /*Set source B of delay measurement to CH2*/ 
:MEASure:SETup:DSB? /*The query returns CHAN2*/ 


Related :MEASure:ITEM 
Command 


:MEASure:STATistic:DISPlay 
Syntax :MEASure:STATistic:DISPlay <bool> 
:MEASure:STATistic: DISPlay? 


Description Enable or disable the statistic function, or query the status of the statistic function. 


Parameter Name Type Range Default 
<bool> | Bool {{1]ON}|{0|OFF}} 0|OFF 


Explanation When the statistic function is enabled, the oscilloscope makes statistic and displays the 
statistic results of at most 5 measurement items that are turned on last. 


Return The query returns 1 or 0. 
Format 


Example :MEASure:STATistic:DISPlay ON /*Enable the statistic function*/ 
:MEASure:STATistic: DISPlay? /*The query returns 1*/ 


Related :MEASure:STATistic: MODE 

Commands  .weasure:STATistic:RESet 

:MEASure:STATistic: ITEM 
:MEASure:ITEM 
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:-MEASure:STATistic: MODE 
Syntax :MEASure:STATistic: MODE <mode> 
:MEASure:STATistic: MODE? 


Description Set or query the statistic mode. 


Parameter Name Type Range Default 


<mode> | Discrete {DIFFerence|EXTRemum} EXTRemum 


Explanation > DiFFerence: select the difference mode. The statistic results contain the current 
value, average value, standard deviation, and counts. 


> EXTRemum: select the extremum mode. The statistic results contain the current 
value, average value, minimum, and maximum. 


> Sending the :MEASure:STATistic:DISPlay command can enable the statistic function. 
When the statistic function is enabled, the oscilloscope makes statistic and displays 
the statistic results of at most 5 measurement items that are turned on last. 


Return The query returns DIFF or EXTR. 
Format 


Example :MEASure:STATistic: MODE DIFFerence /*Select the difference mode*/ 
:MEASure:STATistic: MODE? /*The query returns DIFF*/ 


Related :MEASure:STATistic:RESet 
Commands weasure:STATistic: ITEM 


:-MEASure:STATistic: RESet 
Syntax :MEASure:STATistic:RESet 
Description Clear the history data and make statistic again. 
Related :MEASure:STATistic:DISPlay 
Commands  weasure:STATistic: MODE 
:MEASure:STATistic: ITEM 


MSO1000Z/DS1000Z Programming Guide 2-123 


RIGOL Chapter 2 Command System 


:MEASure:STATistic:ITEM 
Syntax :MEASure:STATistic:ITEM <item>[,<src>[,<src>]] 
:MEASure:STATistic:ITEM? <type>,<item>[,<src>[,<src>]] 


Description Enable the statistic function of any waveform parameter of the specified source, or query 
the statistic result of any waveform parameter of the specified source. 


Parameter Name | Type Range Default 


{VMAX|VMIN|VPP|VTOP|VBASe|VAMP]|VAVG| 
VRMS|OVERshoot|PREShoot| MARea|MPARea| 
PERiod| FREQuency|RTIMe|FTIMe]|PWIDth| 
<item> | Discrete | NWIDth|PDUTy|NDUTy|RDELay|FDELay| - 
RPHase]| FPHase| TVMAX| TVMIN|PSLEWrate| 
NSLEWrate|VUPper|VMID| VLOWer|VARIance| 
PVRMS|PPULses|NPULses| PEDGes| NEDGes} 


<src> Discrete | Refer to Explanation 


<type> | Discrete {MAXimum|MINimum|CURRent|AVERages| = 
P DEViation} 


Explanation > _ [,<src>[,<src>]] sets the source of the parameter to be measured. 


> When <item> is PERiod, FREQuency, PWIDth, NWIDth, PDUTy, NDUTy, RDELay, 
FDELay, RPHase, or FPHase, the range of <src> is 
{D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D11]D12|D13|D14|D15|CHANneli|CHAN 
nel2|CHANnel3|CHANnel4|MATH}. 
When <item> is any of other measurement parameters, the range of <src> is 
{CHANnel1|CHANnel2|CHANnel3|CHANnel4|MATH}. 


> If the parameter to be measured only needs a single source (VMAX, VMIN, VPP, 
VTOP, VBASe, VAMP, VAVG, VRMS, OVERshoot, MARea, MPARea, PREShoot, PERiod, 
FREQuency, RTIMe, FTIMe, PWIDth, NWIDth, PDUTy, NDUTy, TVMAX, TVMIN, 
PSLEWrate, NSLEWrate, VUPper, VMID, VLOWer, VARIance, PVRMS, PPULses, 
NPULses, PEDGes, and NEDGes), you only need to set a single source. If 
[,<src>[,<src>]] is omitted, the source is the one selected by the :MEASure:SOURce 
command by default. 


> If the parameter to be measured needs two sources (RDELay, FDELay, RPHase, and 
FPHase), the command needs to include two sources; otherwise, the command is 
invalid. If [,<src>[,<src>]] is omitted, the sources are the ones selected by 
the :MEASure:SETup:DSA and :MEASure:SETup:DSB or :MEASure:SETup:PSA 
and :MEASure:SETup:PSB commands by default. 


Return The query returns the statistic result in scientific notation. 
Format 


Example :MEASure:STATistic: ITEM VPP,CHANnel2  /*Enable the Vpp statistic function of CH2*/ 
:MEASure:STATistic:ITEM? MAXimum,VPP —_/*The query returns 9.120000e-01*/ 
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‘MEASure:ITEM 


Syntax :MEASure:ITEM <item>[,<src>[,<src>]] 


:MEASure:ITEM? <item>[,<src>[,<src>]] 


Description Measure any waveform parameter of the specified source, or query the measurement 
result of any waveform parameter of the specified source. 


Parameter Name Type Range Default 


{VMAX|VMIN|VPP|VTOP|VBASe|VAMP|VAVG| 
VRMS]|OVERshoot|PREShoot|MARea|MPARea| 
PERiod|FREQuency|RTIMe|FTIMe]|PWIDth| 


<item> | Discrete | NWIDth|PDUTy|NDUTy|RDELay|FDELay| = 


RPHase|FPHase| TVMAX| TVMIN|PSLEWrate| 
NSLEWrate|VUPper|VMID|VLOWer|VARIance| 
PVRMS|PPULses| NPULses|PEDGes|NEDGes} 


<src> Discrete Refer to Explanation 


Explanation > 
> 


[,<src>[,<src>]] sets the source of the parameter to be measured. 


When <item> is PERiod, FREQuency, PWIDth, NWIDth, PDUTy, NDUTy, RDELay, 
FDELay, RPHase, or FPHase, the range of <src> is 
{D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D11]D12|D13|D14|D15|CHANneli|CHAN 
nel2|CHANnel3|CHANnel4|MATH}. 

When <item> is any of other measurement parameters, the range of <src> is 
{CHANnel1|CHANnel2|CHANnel3|CHANnel4|MATH}. 


If the parameter to be measured only needs a single source (VMAX, VMIN, VPP, 
VTOP, VBASe, VAMP, VAVG, VRMS, OVERshoot, MARea, MPARea, PREShoot, PERiod, 
FREQuency, RTIMe, FTIMe, PWIDth, NWIDth, PDUTy, NDUTy, TVMAX, TVMIN, 
PSLEWrate, NSLEWrate, VUPper, VMID, VLOWer, VARIance, PVRMS, PPULses, 
NPULses, PEDGes, and NEDGes), you only need to set a single source. If 
[,<src>[,<src>]] is omitted, the source is the one selected by the :MEASure:SOURce 
command by default. 


If the parameter to be measured needs two sources (RDELay, FDELay, RPHase, and 
FPHase), the command needs to include two sources; otherwise, the command is 
invalid. If [,<src>[,<src>]] is omitted, the sources are the ones selected by 


the :MEASure:SETup:DSA and :MEASure:SETup:DSB or :MEASure:SETup:PSA 
and :MEASure:SETup:PSB commands by default. 


Return The query returns the measurement result in scientific notation. 


Format 


Example :MEASure:ITEM OVERshoot,CHANnel2  /*Enable the overshoot measurement of CH2*/ 
:MEASure:ITEM? OVERshoot,CHANnel2 /*The query returns 8.888889e-03*/ 
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-REFerence Commands 


The :REFerence commands are used to set the reference waveform parameters. 


Command List: 


:REFerence:DISPlay 
:-REFerence<n>:ENABle 


:REFerence<n>:SOURce 
:REFerence<n>:VSCale 
:REFerence<n>:VOFFset 


:REFerence<n>:RESet 
:REFerence<n>:CURRent 


:REFerence<n>:SAVe 


$¢e¢¢ &¢%¢ O O 


:REFerence<n>:COLor 


:REFerence:DISPlay 
Syntax :REFerence:DISPlay <bool> 
:REFerence:DISPlay? 


Description Enable or disable the REF function, or query the status of the REF function. 


Parameter Name Type Range Default 
<bool> Bool {{1]ON}|{0|OFF}} O|OFF 
Return The query returns 1 or 0. 
Format 
Example :REFerence:DISPlay ON /*Enable the REF function*/ 
:REFerence:DISPlay? /*The query returns 1*/ 


-REFerence<n>:ENABle 
Syntax :REFerence<n>:ENABle <bool> 
:REFerence<n>:ENABle? 


Description Enable or disable the specified reference channel, or query the status of the specified 
reference channel. 


Parameter Name Type Range Default 
<n> Discrete {1]2]3]4]5]6]7|8]9]10} 1 
Ref1: 1]ON 
<bool> Bool {{1]ON}|{0]OFF}} oe ioe 


Return The query returns 1 or 0. 
Format 


Example = :REFerencei:ENABle ON /*Enable reference channel 1*/ 
:REFerence1:ENABle? /*The query returns 1*/ 


2-126 MSO1000Z/DS1000Z Programming Guide 


Chapter 2 Command System 


‘REFerence<n>:SOURCe 


Syntax 


Description 


Parameter 


Explanation 


Return Format 


Example 


RIGOL 
:REFerence<n>:SOURce <source> 
:REFerence<n>:SOURce? 
Set or query the source of the current reference channel. 
Name Type Range Default 
<n> Discrete | {1|2|3]4|5|6]7|8|9]10} - 
{D0|D1i|D2|D3|D4|D5|D6|D7|D8|D9|D10| 
<source> | Discrete | D11|D12|D13|D14|D15|CHANnel1| CHANnelt1 
CHANnel2|CHANnel3 |CHANnel4|MATH} 


Only channels currently enabled can be selected as the source of the current reference 
channel. 

The query returns DO, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, 
D15, CHAN1, CHAN2, CHAN3, CHAN4, or MATH. 


:REFerence1:SOURce CHANneli 
:REFerence1:SOURce? 


/*Set the source of reference channel 1 to CH1*/ 
/*The query returns CHAN1*/ 


-REFerence<n>:VSCale 


Syntax 


Description 


Parameter 


Explanation 


Return Format 


Example 


Related 
Commands 


:REFerence<n>:VSCale <scale> 
:REFerence<n>:VSCale? 


Set or query the vertical scale of the specified reference channel. The unit is the 
same as the unit of the source. 


Name Type Range Default 

<n> Discrete | {1]2|3]4]5|6|7|8|9|10} == 
Related to the probe ratio 

<scale> Real When probe ratio is 1X: 1mV to 10V 100mV 
When probe ratio is 10X: 10mV to 100V 


This command is valid only when the specified reference channel has stored 
reference waveform. Otherwise, "No reference data!" will be displayed when 
sending this command. 


The query returns the vertical scale in scientific notation. 


:REFerence1:VSCale 2 
:REFerence1:VSCale? 


:REFerence<n>:SOURce 
:CHANnel<n>:PROBe 


/*Set the vertical scale of reference channel 1 to 2V*/ 
/*The query returns 2.000000e+00*/ 
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‘REFerence<n>:VOFFset 
:REFerence<n>:VOFFset <offset> 


:REFerence<n>:VOFFset? 


Syntax 


Description 


Parameter 


Explanation 
Return Format 


Example 


Related 
Commands 


Chapter 2 Command System 


Set or query the vertical offset of the specified reference channel. The unit is the 
same as the unit of the source. 


Name Type Range Default 
<n> Discrete | {1]2|3|4]5]6|7|8|9|10} - 
<offset> | Real (-10 x RefVerticalScale) to (10 x RefVerticalScale) | 0 


RefVerticalScale refers to the vertical scale of the reference channel. 


The query returns the vertical offset in scientific notation. 


:REFerence1:VOFFset 0.5 


:REFerence1:VOFFset? 


500mv*/ 
/*The query returns 5.000000e-01*/ 


:REFerence<n>:SOURce 


:REFerence<n>:VSCale 


‘REFerence<n>:RESet 


Syntax 


:REFerence<n>:RESet 


/*Set the vertical offset of reference channel 1 to 


Description Reset the vertical scale and vertical offset of the specified reference channel to their 
default values. 


Parameter 


‘REFerence<n>:CURRent 


Syntax 
Description 


Parameter 


Explanation 


Related 
Command 


Name Type Range Default 
<n> Discrete | {1]2|3]4|5]6|7|8|]9|10} -- 
:REFerence<n>:CURRent 
Select the current reference channel. 
Name Type Range Default 
<n> Discrete | {1|2|3]4|5]6|7|8|9|10} 1 


Only reference channels currently turned on can be selected as the current 


reference channel. 


:REFerence<n>:ENABle 
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-REFerence<n>:SAVe 
Syntax :REFerence<n>:SAVe 
Description Store the waveform of the current reference channel to the internal memory as 
reference waveform. 
Parameter Name Type Range Default 
<n> Discrete {1|2|3|4]5]6]7|8|9|10} = 
Related :REFerence<n>:CURRent 
Command 
:REFerence<n>:COLor 
Syntax :REFerence<n>:COLor <color> 
:REFerence<n>:COLor? 
Description Set or query the display color of the current reference channel. 
Parameter Name Type Range Default 
<n> Discrete {1|2|3|4]5]6]7|8|9|10} == 
<color> | Discrete {GRAY|GREEn|LBLue|MAGenta|ORANge} GRAY 


Return Format 


Example 


Related 
Command 


The query returns GRAY, GREE, LBL, MAG, or ORAN. 
:REFerence1:COLor GREEn  /*Set the display color of reference channel 1 (the 


:REFerence1i:COLor? 
:REFerence<n>:CURRent 


current reference channel) to GREEn*/ 


/*The query returns GREE*/ 
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[:SOURce[<n>]] Commands 


The [:SOURce[<n>]] commands are used to set the parameters of the built-in signal source. <n> can be 1 
or 2 which denotes the corresponding built-in signal source channel. When <n> or :SOURce[<n>] is 
omitted, the operation will be applied to source 1 by default. These commands are only applicable to 
models with source channels of MSO1000Z/DS1000Z series. 


Command List: 


of? HHH HHHHHHH HHH HHH HHH HF FM 


[:SOURce[<n>]]:OUTPut[<n>][:STATe] 
[:SOURce[<n>]]:OUTPut[<n>]:IMPedance 
[:SOURce[<n>]]:FREQuency[:FIxXed] 
[:SOURce[<n>]]:PHASe[:ADJust] 

[:SOURce[ <n>]]:PHASe:INITiate 

[:SOURce[ <n>]]:FUNCtion[:SHAPe] 

[:SOURce[ <n>]]:FUNCtion:RAMP:SYMMetry 
[:SOURce[<n>]]:VOLTage[ :LEVel][:IMMediate][:AMPLitude] 
[:SOURce[ <n>]]:VOLTage[ :LEVel][:IMMediate]:OFFSet 
[:SOURce[<n>]]:PULSe: DCYCle 
[:SOURce[<n>]]:MOD[:STATe] 

[: SOURce[<n>]]:MOD:TYPe 
[:SOURce[<n>]]:MOD:AM[:DEPTh] 
[:SOURce[<n>]]:MOD:AM:INTernal:FREQuency 
[:SOURce[<n>]]:MOD:FM:INTernal:-FREQuency 
[:SOURce[<n>]]:MOD:AM:INTernal:FUNCtion 
[:SOURce[<n>]]:MOD:FM:INTernal:FUNCtion 
[:SOURce[<n>]]:MOD:FM[:DEVIation] 
[:SOURce[<n>]]:APPLy? 
[:SOURce[<n>]]:APPLy:NOISe 
[:SOURce[<n>]]:APPLy:PULSe 

[: SOURce[ <n>]]:APPLy:RAMP 
[:SOURce[<n>]]:APPLy:SINusoid 
[:SOURce[<n>]]:APPLy:SQUare 

[: SOURce[ <n>]]:APPLy:USER 
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[:SOURce[<n>]]:OUTPut[<n>][:STATe] 
Syntax [:SOURce[<n>]]:OUTPut[<n>][:STATe] <bool> 
[:SOURce[<n>]]:OUTPut[ <n>][:STATe]? 


Description Turnon or off the output of the specified source channel, or query the status of the output 
of the specified source channel. 


Parameter Name Type Range Default 
If omitted, the operation is 
[<n>] Discrete | {1|2} performed on source 1 by 
default 
<bool> Bool {{1]ON}|{0|OFF}} O|OFF 


Explanation [:SOURce[<n>]] and :OUTPut [<n>] are used to specify the source channel. The former 
enjoys higher priority over the latter; namely if the former is omitted, the channel is 
specified by the latter and if the former is not omitted, the channel is specified by the 
former. 


Return The query returns OFF or ON. 
Format 


Example :OUTPut 1 /*Turn on the output of source 1*/ 
:OUTPut? /*The query returns ON*/ 


[:SOURce[<n>]]:OUTPut[<n>]:IMPedance 
Syntax [:SOURce[<n>]]:OUTPut[<n>]:IMPedance <impedance> 
[:SOURce[ <n>]]:OUTPut[ <n>]:IMPedance? 


Description Set or query the impedance of the specified source channel. 


Parameter Name Type Range Default 
If omitted, the operation is 
[<n>] Discrete | {1|2} performed on source 1 by 
default 
<impedance> | Discrete | {OMEG|FIFTy} OMEG 


Explanation > [:SOURce[<n>]] and :OUTPut [<n>] are used to specify the source channel. The 
former enjoys higher priority over the latter, namely if the former is omitted, the 
channel is specified by the latter and if the former is not omitted, the channel is 
specified by the former. 


> OMEG: highZ; FIFTy: 50Q 


Return The query returns OMEG or FIFT. 
Format 


Example :OUTPut:IMPedance FIFTy /*Set the output impedance of source 1 to 50Q*/ 
:OUTPut:IMPedance? /*The query returns FIFT*/ 
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[:SOURce[<n>]]:FREQuency[:FIXed] 
Syntax [:SOURce[<n>]]:FREQuency[:FIXed] <frequency> 
[:SOURce[ <n>]]:FREQuency[:FIXed]? 


Description Set or query the output frequency of the specified source channel if the modulation is not 
enabled or the carrier frequency if the modulation is enabled. The default unit is Hz. 


Parameter Name Type Range Default 
If omitted, the operation is 
[<n>] Discrete | {1|2} performed on source 1 by 
default 


Sine: 0.1Hz to 25MHz 
Square: 0.1Hz to 15MHz 
Pulse: 0.1Hz to 1MHz 

Ramp: 0.1Hz to 100kHz 
Arbitrary waveform: 0.1Hz to 


<frequency> | Real 1kHz 


10MHz 
Return The query returns the frequency in scientific notation, such as 2.0000000e+05. 
Format 
Example :FREQuency 1000 /*Set the output frequency of source 1 to 1kHz*/ 


:FREQuency? /*The query returns 1.0000000e+03*/ 


Related [:SOURce[<n>]]:MOD[:STATe] 
a ae [:SOURce[<n>]]:MOD:TYPe 


[:SOURce[<n>]]:PHASe[:ADJust] 
Syntax [:SOURce[<n>]]:PHASe[:ADJust] <phase> 
[:SOURce[ <n>]]:PHASe[:ADJust]? 
Description Set or query the start phase of the specified source channel. The default unit is degree 


(°). 
Parameter Name Type Range Default 
If omitted, the operation is 
[<n>] Discrete | {1]2} performed on source 1 by 
default 
<phase> Real 0 to 360 0 
Return The query returns the start phase in scientific notation, such as 0.000000e+00. 
Format 
Example  :PHASe 90 /*Set the start phase of source 1 to 90°*/ 


:PHASe? /*The query returns 9.000000e+01*/ 
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[:SOURce[<n>]]:PHASe:INITiate 
Syntax [:SOURce[<n>]]:PHASe:INITiate 


Description Execute the align phase operation. 


Parameter Name Type Range Default 
If omitted, the 
[<n>] Discrete | {1|2} operation is performed 
on source 1 by default 


Explanation When the align phase operation is performed, the instrument re-configures the two 
channels to make them output with the specified frequency and phase. 


For two signals whose frequencies are the same or in multiple, this operation will align 
their phases. For example, assume Sourcei output a 1kHz, 5Vpp, 0° sine waveform and 
Source2 outputs a 1kHz, 5Vpp, 180° sine waveform. Sample the two waveforms using 
another oscilloscope and display them stably; you will see that the waveforms shown on 
the oscilloscope do not always have a phase deviation of 180°. At this point, execute the 
align phase operation and the waveforms shown on the oscilloscope will have a phase 
deviation of 180° without any manual adjustment of the start phase of the generator. 


Before Aligning Phase After Aligning Phase 


[:SOURce[<n>]]:FUNCtion[:SHAPe] 
Syntax [:SOURce[<n>]]:FUNCtion[:SHAPe] <wave> 
[:SOURce[ <n>]]:FUNCtion[:SHAPe]? 


Description Select or query the output waveform when the modulation of the specified source channel 
is not enabled. Select or query the carrier waveform when the modulation is enabled. At 
this point, if PULSe, NOISe or DC is selected, the modulation will turn off automatically. 


Parameter Name Type Range Default 
If omitted, the 
[<n>] Discrete | {1|2} operation is performed 


on source 1 by default 


{SINusoid| SQUare] RAMP|PULSe| 
NOISe|DC|EXTernal| | SINC|EXPRise| 
EXPFall|ECG|GAUSs|LORentz| 
HAVersine} 


<wave> | Discrete SINusoid 


Explanation >  EXTernal: arbitrary waveform 


> MS0O1000Z/DS1000Z provides 7 built-in waveforms: Sinc, Exp.Rise, Exp.Fall, ECG, 
Gauss, Lorentz, and Haversine 


Return § The query returns SIN, SQU, RAMP, PULS, NOIS, DC, EXT, SINC, EXPR, EXPF, ECG, GAUS, 
Format LOR, or HAV. 


Example :FUNCtion SQUare /*Set the output waveform of source 1 to square*/ 
:FUNCtion? /*The query returns SQU*/ 
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[:SOURce[<n>]]:FUNCtion:RAMP:SYMMetry 
Syntax [:SOURce[<n>]]:FUNCtion:RAMP:SYMMetry <val> 
[:SOURce[ <n>]]:FUNCtion:RAMP:SYMMetry? 


Description Set or query the ramp symmetry (the percentage that the rising period takes up in the 
whole period) of the specified source channel. 


Parameter Name Type Range Default 
If omitted, the operation is 
[<n>] Discrete | {1|2} performed on source 1 by 
default 
<val> Real 0 to 100 10 
Return § The query returns the symmetry in scientific notation, such as 5.000000e+01. 
Format 
Example  :FUNCtion:RAMP:SYMMetry 50 /*Set the ramp symmetry of source 1 to 50%*/ 
:FUNCtion:RAMP:SYMMetry? /*The query returns 5.000000e+01*/ 
Related [:SOURce[<n>]]:FUNCtion[:SHAPe] 
Command 


[:SOURce[<n>]]:VOLTage[:LEVel][:IMMediate][:AMPLitude] 
Syntax [:SOURce[<n>]]:VOLTage[:LEVel][:IMMediate][:AMPLitude] <Amplitude> 
[:SOURce[ <n>]]:VOLTage[:LEVel][:IMMediate][:AMPLitude]? 


Description Set or query the output amplitude of the specified source channel. The default unit is Vpp. 


Parameter Name Type Range Default 
If omitted, the operation is 
[<n>] Discrete | {1]2} performed on source 1 by 
default 


Related to the output 
impedance 

HighZ: 20mVpp to 5Vpp 
502: 10mVpp to 2.5Vpp 


Explanation You can use the [:SOURce[<n>]]:OUTPut[<n>]:IMPedance command to set the output 
impedance. 


<Ampliude> | Real SVpp 


Return The query returns the amplitude in scientific notation, such as 1.0000000e+00. 
Format 


Example :VOLTage 2 /*Set the output amplitude of source 1 to 2V*/ 
:VOLTage? /*The query returns 2.0000000e+00*/ 
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[:SOURce[<n>]]:VOLTage[:LEVel][:IMMediate]:OFFSet 
Syntax [:SOURce[<n>]]:VOLTage[:LEVel] [:IMMediate]:OFFSet <offset> 
[:SOURce[<n>]]:VOLTage[:LEVel] [:IMMediate]:OFFSet? 


Description Set or query the DC offset of the specified source channel. The default unit is Vpc. 


Parameter Name Type Range Default 


If omitted, the 
operation is 
performed on 
source 1 by default 


[<n>] Discrete | {1|2} 


Related to the output impedance and 
amplitude 
HighZ: (-2.5V + current amplitude/2) to 
(2.5V - current amplitude/2) 
50Q: (-1.25V + current amplitude/2) to 
(1.25V - current amplitude/2) 


<offset> | Real OuV oc 


Explanation > You can use the [:SOURce[<n>]]:OUTPut[<n>]:IMPedance command to set the 
output impedance. 


> You can use the [:SOURce[<n>]]:VOLTage[:LEVel][:IMMediate][:AMPLitude] 


command to set the output amplitude. 


Return The query returns the DC offset in scientific notation, such as 1.0000000e+00. 
Format 


Example :VOLTage:OFFSet 0.5 /*Set the DC offset of source 1 to 500mMVpc*/ 
:VOLTage:OFFSet? /*The query returns 5.0000000e-01*/ 


[:SOURce[<n>]]:PULSe:DCYCle 
Syntax [:SOURce[<n>]]:PULSe:DCYCle <percent> 
[:SOURce[ <n>]]:PULSe:DCYCle? 


Description Set or query the pulse duty cycle (the percentage that the high level takes up in the whole 
period) of the specified source channel. 


Parameter Name Type Range Default 
If omitted, the 
[<n>] Discrete | {1|2} operation is 


performed on 
source 1 by default 


<percent> | Real 10 to 90 20 
Return The query returns the duty cycle in scientific notation, such as 5.000000e+01. 
Format 
Example :PULSe:DCYCle 50 /*Set the pulse duty cycle of source 1 to 50%*/ 
:PULSe: DCYCle? /*The query returns 5.000000e+01*/ 
Related [:SOURce[<n>]]:FUNCtion[:SHAPe] 
Command 
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[:SOURce[<n>]]:MOD[:STATe] 
Syntax [:SOURce[<n>]]:MOD[:STATe] <bool> 
[:SOURce[<n>]]:MOD[:STATe]? 


Description Enable or disable the modulation of the specified source channel, or query the status of 
the modulation of the specified source channel. 


Parameter Name Type Range Default 


If omitted, the operation is 


Esha pales {12} performed on source 1 by default 


<bool> Bool {{1]ON}|{0|OFF}} O|OFF 


Explanation > _ The signal source of MSO1000Z/DS1000Z provides amplitude modulation (AM) and 
frequency modulation (FM) which can be selected by sending the 
[:SOURce[<n>]]:MOD:TYPe command. 


> Sine, Square, Ramp, Built-in waveforms, or Arb waveform (except DC) can be used 
as the carrier waveform. 


> You can use the [:SOURce[ <n>]]:MOD:AM:INTernal: FUNCtion or 
[:SOURce[<n>]]:MOD:FM:INTernal: FUNCtion command to selelct Sine, Square, 


Triangle, or Noise as the modulating waveform. 


Return The query returns OFF or ON. 


Format 
Example :MOD ON /*Enable the modulation of source 1*/ 
:MOD? /*The query returns ON*/ 
Related [:SOURce[<n>]]:FUNCtion[:SHAPe] 


Command 


[:SOURce[<n>]]:MOD:TYPe 
Syntax [:SOURce[<n>]]:MOD:TYPe <type> 
[:SOURce[<n>]]:MOD:TYPe? 


Description Set or query the modulation type of the specified source channel. 


Parameter Name Type Range Default 


If omitted, the operation is 
performed on source 1 by default 


<type> Discrete {AM|FM} AM 


Explanation > AM: amplitude modulation. The amplitude of the carrier waveform varies with the 
amplitude of the modulating waveform. 
FM: frequency modulation. The frequency of the carrier waveform varies with the 
amplitude of the modulating waveform. 


[<n>] Discrete {1]2} 


> Sine, Square, Ramp, Built-in waveforms, or Arb waveform (except DC) can be used 
as the carrier waveform. 


> You can use the [:SOURce[<n>]]:MOD:AM:INTernal:FUNCtion or 
[:SOURce[<n>]]:MOD:FM:INTernal: FUNCtion command to selelct Sine, Square, 
Triangle, or Noise as the modulating waveform. 


Return The query returns AM or FM. 
Format 


Example :MOD:TYPe AM /*Set the modulation type of source 1 to AM*/ 
:MOD:TYPe? /*The query returns AM*/ 
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[:SOURce[<n>]]:MOD:AM[:DEPTh] 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


[:SOURce[<n>]]:MOD:AM[:DEPTh] <depth> 
[:SOURce[<n>]]:MOD:AM[:DEPTh]? 


Set or query the AM modulation depth (indicates the amplitude variation degree and is 
expressed as a percentage) of the specified source channel. 


Name Type Range Default 

, If omitted, the operation is 
ad Discrete | {1|2} performed on source 1 by default 
<depth> Real 0 to 120 100 


In 0% modulation, the output amplitude is half of the carrier waveform amplitude. 

In 100% modulation, the output amplitude is equal to the carrier waveform amplitude. 
In >100% modulation, envelop distortion which should be avoided in the real circuit will 
occur and the output amplitude of the instrument would not exceed 5Vpp (502 load). 


The query returns an integer. 


:MOD:AM 80 
:MOD:AM? 


/*Set the AM modulation depth of source 1 to 80%*/ 
/*The query returns 80*/ 


[:SOURce[<n>]]:MOD:AM:INTernal:FREQuency 
[:SOURce[<n>]]:MOD:FM:INTernal:FREQuency 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


[:SOURce[<n>]]:MOD:AM:INTernal:FREQuency <frequency> 
[:SOURce[<n>]]:MOD:AM:INTernal: FREQuency? 
[:SOURce[<n>]]:MOD:FM:INTernal:FREQuency <frequency> 
[:SOURce[<n>]]:MOD:FM:INTernal: FREQuency? 


Set or query the modulating waveform frequency of AM or FM of the specified source 
channel. The default unit is Hz. 


Name Type Range Default 

. If omitted, the operation is 
[sn] Discrete | {1|2} performed on source 1 by default 
<frequency> | Real 1Hz to 50kHz 1kHz 


> Sending the [:SOURce[<n>]]:MOD:TYPe command can set the modulation type. 


> AM: amplitude modulation. The amplitude of the carrier waveform varies with the 
amplitude of the modulating waveform. 
FM: frequency modulation. The frequency of the carrier waveform varies with the 
amplitude of the modulating waveform. 


> Sending [:SOURce[ <n>]]:MOD:AM:INTernal:FUNCtion or 
[:SOURce[<n>]]:MOD:FM:INTernal:FUNCtion can selelct Sine, Square, Triangle, or 


Noise as the modulating waveform. 


The query returns an integer. 


:MOD:AM:INTernal:FREQuency 100 /*Set the modulating waveform frequency of AM 
of source 1 to 100Hz*/ 


:MOD:AM:INTernal:FREQuency? /*The query returns 100*/ 
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[:SOURce[<n>]]:MOD:AM:INTernal:FUNCtion 
[:SOURce[<n>]]:MOD:FM:INTernal:FUNCtion 
Syntax [:SOURce[<n>]]:MOD:AM:INTernal:FUNCtion <wave> 
[:SOURce[<n>]]:MOD:AM:INTernal:FUNCtion? 
[:SOURce[<n>]]:MOD:FM:INTernal:FUNCtion <wave> 
[:SOURce[<n>]]:MOD:FM:INTernal:FUNCtion? 


Description Set or query the modulating waveform of AM or FM of the specified source channel. 


Parameter Name Type Range Default 
If omitted, the 
: operation is 
[<n>] Discrete | {1|2} performed on source 
1 by default 
<wave> | Discrete | {SINusoid|SQUare|TRIangle|NOISe} | SINusoid 


Explanation > Sine (SINusoid), Square (SQUare), Triangle (TRIangle), or Noise (NOISe) can be 
selected as the modulating waveform. You can set the frequency of the modulating 
waveform by sending [:SOURce[<n>]]:MOD:AM:INTernal:FREQuency or 
[:SOURce[<n>]]:MOD:FM:INTernal:FREQuency. 


> Sending the [:SOURce[<n>]]:MOD:TYPe command can set the modulation type. 


> AM: amplitude modulation. The amplitude of the carrier waveform varies with the 
amplitude of the modulating waveform. 
FM: frequency modulation. The frequency of the carrier waveform varies with the 
amplitude of the modulating waveform. 


Return The query returns SIN, SQU, TRI, or NOIS. 


Format 


Example :MOD:AM:INTernal:FUNCtion SQUare /*Set the modulating waveform of AM of 


source 1 to square*/ 


:MOD:AM:INTernal:FUNCtion? /*The query returns SQU*/ 
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[:SOURce[<n>]]:MOD:FM[:DEVIation] 
Syntax [:SOURce[<n>]]:MOD:FM[:DEVIation] <dev> 
[:SOURce[<n>]]:MOD:FM[:DEVIation]? 


Description Set or query the FM frequency deviation of the specified source channel. The default unit 


is Hz. 
Parameter Name_ | Type Range Default 
If omitted, the operation is 
[<n>] Discrete | {1|2} performed on source 1 by 
default 
Zdys Real OHz to the carrier waveform tkHz 


frequency 


Explanation > Sending [:SOURce[<n>]]:FREQuency[:FIXed] can set the carrier waveform 
frequency and sending [:SOURce[<n>]]:MOD:FM:INTernal: -FREQuency can set the 


FM modulation frequency. 


> When the modulating waveform amplitude reaches its maximum, the carrier 
waveform frequency increases by the "frequency deviation". When the modulating 
waveform amplitude reaches its minimum, the carrier waveform frequency 
decreases by the "frequency deviation". 


> You can only set the FM frequency deviation when the modulation type of the 
specified signal source channel is set to FM. 


Return The query returns an integer. 
Format 


Example :MOD:FM 100 /*Set the FM frequency deviation of source 1 to 100Hz*/ 
:MOD:FM? /*The query returns 100*/ 


[:SOURce[<n>]]:APPLy? 
Syntax [:SOURce[<n>]]:APPLy? 
Description Query the output configurations of the specified source channel. 


Parameter Name Type Range Default 
If omitted, the operation is 
[<n>] Discrete | {1]2} performed on source 1 by 
default 


Return The query returns the output configurations in "<waveform 
Format name>,<frequency>,<amplitude>,<offset>,<start phase>" format. If the 
corresponding parameter does not exist, it will be replaced by "DEF". 


Example _:APPLy? /*The query returns SIN, 1000.000000,1.000000,0.000000,0.000000*/ 
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[:SOURce[<n>]]:APPLy:NOISe 

[:SOURce[<n>]]:APPLy:PULSe 

[:SOURce[<n>]]:APPLy:RAMP 

[:SOURce[<n>]]:APPLy:SINusoid 

[:SOURce[<n>]]:APPLy:SQUare 

[:SOURce[<n>]]:APPLy:USER 

Syntax [:SOURce[<n>]]:APPLy:NOISe [<amp>[,<offset>]] 

[:SOURce[<n>]]:APPLy:PULSe [<freq>[,<amp>[,<offset>[,<phase>]]]] 
[:SOURce[<n>]]:APPLy:RAMP [<freq>[,<amp>[,<offset>[,<phase>]]]] 
[:SOURce[<n>]]:APPLy:SINusoid [<freq>[,<amp>[,<offset>[,<phase>]]]] 
[:SOURce[<n>]]:APPLy:SQUare [<freq>[,<amp>[,<offset>[,<phase>]]]] 
[:SOURce[<n>]]:APPLy:USER [<freq>[,<amp>[,<offset>[,<phase>]]]] 


Description Configure the specified source channel to output a signal with the specified waveform and 


parameters. 
Parameter Name Type Range Default 
If omitted, the 
operation is 


[<n>] Discrete | {1]2} performed on 


source 1 by default 


Sine: 0.1Hz to 25MHz 
Square: 0.1Hz to 15MHz 
<freq> Real Pulse: 0.1Hz to 1MHz 1kHz 
Ramp: 0.1Hz to 100kHz 

Arbitrary waveform: 0.1Hz to LOMHz 


Related to the output impedance 
<amp> Real HighZ: 20mVpp to 5Vpp 5Vpp 
502: 10mVpp to 2.5Vpp 


Related to the output impedance and 
amplitude 
HighZ: (-2.5V + current amplitude/2) to 


sOliget |: Real (2.5V - current amplitude/2) OVoc 
50Q: (-1.25V + current amplitude/2) to 
(1.25V - current amplitude/2) 
<phase> | Real 0° to 360° 0° 


Explanation > These commands are used to select the waveform shape. 
NOISe: select Noise 
PULSe: select Pulse 
RAMP: select Ramp 
SINusoid: select Sine 
SQUare: select Square 
USER: select Arbitrary waveform 


>  <freq>: set the frequency of the specified waveform (Noise does not have this 
parameter). The default unit is Hz; 
<amp>: set the amplitude of the specified waveform. The default unit is Vpp; 
<offset>: set the DC offset of the specified waveform. The default unit is Vpc; 
<phase>: set the start phase of the specified waveform (Noise does not have this 
parameter). The default unit is degree (°). 
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> Users can omit one or multiple parameters. When all of the parameters are omitted, 
the commands only select the waveform shape but do not modify the parameters. 


> The four parameters (<freq>, <amp>, <offset>, and <phase>) are in order. You 
can not omit one parameter and set the one/ones behind it. For example, you can not 
omit <freq> and set <amp> directly. 
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-STORage Commands 


The :STORage commands are used to set the related parameters when storing images. 
Command List: 

@ :STORage:IMAGe:TYPE 

@ :STORage:IMAGe: INVERT 

@ :STORage:IMAGe:COLor 


:STORage: IMAGe: TYPE 
Syntax :STORage:IMAGe:TYPE <type> 
:STORage:IMAGe: TYPE? 


Description Set or query the image type when storing images. 


Parameter Name Type Range Default 
<type> Discrete {PNG|BMP8|BMP24|JPEG| TIFF} PNG 
Return The query returns PNG, BMP8, BMP24, JPEG, or TIFF. 
Format 
Example :STORage:IMAGe:TYPE PNG /*Set the image type when storing images to PNG*/ 
:STORage: IMAGe: TYPE? /*The query returns PNG*/ 


:STORage: IMAGe: INVERT 
Syntax :STORage:IMAGe:INVERT <bool> 
:STORage: IMAGe: INVERT? 


Description Turn on or off the invert function when storing images; or query the status of the invert 


function. 
Parameter Name Type Range Default 
<bool> Bool {{1|ON}|{0|OFF}} 0|OFF 
Return The query returns ON or OFF. 
Format 
Example :STORage:IMAGe:INVERT ON /*Turn on the invert function when storing images*/ 
:STORage: IMAGe: INVERT? /*The query returns ON*/ 
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:-STORage:IMAGe:COLor 
Syntax :STORage:IMAGe:COLor <bool> 
:STORage:IMAGe:COLor? 


Description Set the image color when storing images to color (ON) or intensity graded color (OFF); or 
query the image color when storing images. 


Parameter Name Type Range Default 


<bool> Bool {ON|OFF} ON 


Return The query returns ON or OFF. 
Format 


Example :STORage:IMAGe:COLor ON /*Set the image color when storing images to color*/ 
:STORage:IMAGe:COLor? /*The query returns ON*/ 
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‘SYSTem Commands 


The :SYSTem commands are used to set the system-related parameters, such as the sound and language. 


Command List: 
:SYSTem:AUToscale 
:SYSTem:BEEPer 
:SYSTem:ERRor[:NEXT]? 
:SYSTem:GAM? 
:SYSTem:LANGuage 
:SYSTem:LOCKed 
:SYSTem:PON 
:SYSTem:OPTion:INSTall 
:SYSTem:OPTion: UNINSTall 
:SYSTem:RAM? 
:SYSTem:SETup 


, i A A 2 2 2 


:SYSTem:AUToscale 
Syntax :SYSTem:AUToscale <bool> 
:SYSTem:AUToscale? 
Description Enable or disable the AUTO key at the front panel, or query the status of the AUTO) key. 
Parameter Name Type Range Default 
<bool> | Bool {{1]ON}|{0|OFF}} 1|ON 


Explanation > Users can disable the |AUTO} key by sending this command or pressing |Utility) > 
Auto Options > Lock. The key can only be enabled by sending this command. 


> After the AUTO key is disabled, the Auto Scale operation is invalid. The :AUToscale 
command will be invalid. 


Return The query returns 1 or 0. 
Format 


Example :SYSTem:AUToscale ON /*Enable the AUTO key at the front panel*/ 
:SYSTem:AUToscale? /*The query returns 1*/ 
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-SYSTem:BEEPer 


Syntax :SYSTem:BEEPer <bool> 
:SYSTem:BEEPer? 


Description Enable or disable the beeper, or query the status of the beeper. 


Parameter Name Type Range Default 
<bool> Bool {£1]ON}|{0|OFF}} - 
Return The query returns 1 or 0. 
Format 
Example :SYSTem:BEEPer ON /*Enable the beeper*/ 
:SYSTem:BEEPer? /*The query returns 1*/ 


:SYSTem:ERRor[:NEXT]? 
Syntax :SYSTem:ERRor[:NEXT]? 
Description Query and delete the last system error message. 


Return The query returns the error message in "<message number>,<message content>" 
Format format. Wherein, <message number> is an integer and <message content> is a ASCII 
string. For example, -113,"Undefined header; command cannot be found". 


:-SYSTem:GAM? 
Syntax :SYSTem:GAM? 
Description Query the number of grids in the horizontal direction of the instrument screen. 


Return The query always returns 12. 
Format 


:-SYSTem:LANGuage 
Syntax :SYSTem:LANGuage <lang> 
:SYSTem:LANGuage? 


Description Set or query the system language. 


Parameter Name Type Range Default 


{SCHinese] TCHinese| ENGLish] PORTuguese| 
<lang> Discrete GERMan|POLish|KORean|JAPAnese|FRENch| | -- 
RUSSian} 


Explanation The system language is not affected by sending *RST. 


Return The query returns SCH, TCH, ENGL, PORT, GERM, POL, KOR, JAPA, FREN, or RUSS. 
Format 


Example :SYSTem:LANGuage SCHinese /*Set the system language to simplified Chinese*/ 
:SYSTem:LANGuage? /*The query returns SCH*/ 
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:SYSTem:LOCKed 
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Syntax :SYSTem:LOCKed <bool> 
:SYSTem:LOCKed? 
Description Enable or disable the keyboard lock function, or query the status of the keyboard lock 
function. 
Parameter Name Type Range Default 
<bool> Bool {{1]ON}|{0|OFF}} 0|OFF 
Return The query returns 1 or 0. 
Format 
:SYSTem:PON 
Syntax :SYSTem:PON <pon> 
:SYSTem:PON? 
Description Set or query the system configuration to be recalled when the oscilloscope is powered on 
again after power-off. 
Parameter Name Type Range Default 
<pon> Discrete {LATest|DEFault} LATest 
Return The query returns LAT or DEF. 
Format 
Example :SYSTem:PON LATest /*Set the system configuration to be recalled when the 


oscilloscope is powered on again after power-off to last*/ 


:SYSTem:PON? 


/*The query returns LAT*/ 


:SYSTem:OPTion:INSTall 


Syntax :SYSTem:OPTion:INSTall <license> 
Description Install a option. 
Parameter Name Type Range Default 
<license> ASCII String | Refer to Explanation - 


Explanation > _ To install an option, you need to order the option to obtain the corresponding key. 


Then, use the key to acquire the option license by following the steps below. 


@ Log in RIGOL official website (www.rigol.com); click SERVICE > Software 
License Register to enter the product license register interface. 


@ Input the correct key, serial number (press Utility) > System > System Info 
to get the instrument serial number) and identifying code in the product license 
register interface; click Generate to acquire the option license. 


>  <license> is the option license (the hyphens should be omitted). It is a 28-byte string 
and can only include uppercase English characters and numbers. 


Example :SYSTem:OPTion:INSTall PDPUY9NIQTS9PQSWPLAETRD3UJHYA 
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:SYSTem:OPTion:UNINSTall 
Syntax :SYSTem:OPTion:UNINSTall 


Description Uninstall the options installed. 


-SYSTem:RAM? 
Syntax :SYSTem:RAM? 
Description Query the number of analog channels of the instrument. 


Return § The query always returns 4. 
Format 


:SYSTem:SETup 
Syntax :SYSTem:SETup <setup_stream> 
:SYSTem:SETup? 


Description Import the setting parameters of the oscilloscope to restore the oscilloscope to the 
specified setting. 


Query the setting of the oscilloscope. 


Parameter Name Type Range Default 


<setup_stream> Refer to Explanation 


Explanation > Here, the setting of the oscilloscope corresponds to the "Setups" in Storage > 
Storage. 


>  <setup_stream> is the specified setting parameters of the oscilloscope and is the 
return value of the :SYSTem:SETup? command; you cannot set the parameters 
manually. For the specific format, please refer to the Return Format below. 


> This command is mainly used to help users to easily export/import the oscilloscope 
settings remotely. To export the setting parameters of the specified setting of the 
oscilloscope, send the :SYSTem:SETup? command and save the return value to a 
file. After that, if users want to restore the oscilloscope to the specified setting, 
import the setting parameters of the oscilloscope using the :SYSTem:SETup 
<setup_stream> command (note that <setup_stream> must be the return value 
formerly acquired from the query). 


Return The return value consists of two parts, including the TMC data description header and 

Format the setting data. The format of the TMC data description header is #NXXXXXX; wherein, 
# is the denoter, N is lower than or equal to 9 and the N data following it denotes the 
length (the number of bytes) of the data stream. For example, #9000002077; wherein, 
N is 9 and 000002077 denotes that there are 2077 byte effective data. The setting 
data is in binary format. 
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[:TRACe[<n>]] Commands 


The [:TRACe[<n>]] commands are used to set the arbitrary waveform parameters of the built-in signal 
sources. <n> can be 1 or 2 which denotes the corresponding built-in signal source channel. If <n> 

or :TRACe[<n>] is omitted, the operation will be applied to source 1 by default. These commands are only 
applicable to models with source channels of MSO1000Z/DS1000Z series. 


Command List: 

[: TRACe[<n>]]:DATA 

[: TRACe[<n>]]:DATA:DAC16 
[:TRACe[<n>]]:DATA:DAC 

[: TRACe[<n>]]:DATA:POINts 


[:TRACe[<n>]]:DATA:VALue 
[: TRACe[<n>]]:DATA:LOAD? 


, i A A A A A 


[:TRACe[<n>]]:DATA 


[:TRACe[<n>]]:DATA:POINts:INTerpolate 
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Syntax [:TRACe[<n>]]:DATA volatile,<value>[,<value>...] 


Description Download the floating point voltage values to the volatile memory of the specified 


signal source. 


Parameter Name Type Range Default 
<n> Discrete {1|2} 1 
<value> Real -itol -- 


Explanation > <value> denotes the floating point voltage values. -1 and 1 correspond to the 
minimum and maximum values of the waveform amplitude respectively. For 
example, when the amplitude is 5Vpp and the offset is OVpc, -1 corresponds to 
-2.5V and 1 corresponds to 2.5V. This command will overwrite the previous 
waveform in the volatile memory (no error will be generated). 


> 2 to 16384 points can be downloaded each time. 


> After sending this command, the specified signal source channel switches to 
volatile waveform output automatically. While at the same time, the initial number 
of points is modified. Users can edit the data downloaded using this command on 


the instrument. 


Example = :DATA volatile,-0.5,-0.25,0.25,0.75 /*Download 4 floating point voltage values 


(-0.5,-0.25,0.25,0.75) to the volatile memory of 
the source 1*/ 
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[: TRACe[<n>]]:DATA:DAC16 
Syntax [:TRACe[<n>]]:DATA:DAC16 volatile, <flag>,<binary_block_data> 


Description Download binary data block to the volatile memory of the specified signal source. 


Parameter Name Type Range Default 
<n> Discrete | {1|2} 1 
<flag> Discrete | {END} -- 
<binary_block_data> Refer to Explanation 


Explanation > 


This command consists of two parts: the command string 
([:TRACe[<n>]]:DATA:DAC16 volatile,<flag>,) and the binary data 
(<binary_block_data>). 


<flag> denotes the data transmission status and can only be set to END which 
denotes the data transmission finishes. 


<binary_block_data> denotes the binary data to be downloaded. The data length 
ranges from 4Bytes (2pt) to 32kBytes (16kpts). <binary_block_data> is a binary 
data block starts with #. For example, #516384 binary data; the number 5 
behind # denotes that the data length information (16384) occupies 5 characters. 
16384 denotes the number of bytes of the binary data. As each waveform point 
corresponds to two bytes of binary number (the range is from 0000 to 3FFF; 0000 
and 3FFF correspond to the minimum and maximum values of the waveform 
amplitude respectively), the number of bytes must be an even number. 


When END (data transmission complete indicator) is recieved, the instrument 
switches to arbitrary waveform output automatically. 
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[: TRACe[<n>]]:DATA:DAC 


Syntax [:TRACe[<n>]]:DATA:DAC volatile, [<binary_block_data>|<value>,<value>,<value>...] 


Description Download binary data block or decimal waveform values to the volatile memory of the 
specified signal source. 


Parameter Name Type Range Default 


<n> Discrete | {1|2} 1 


<binary_block_data> | Refer to Explanation 


<value> Integer | 0 to 16383 a 


Explanation > 


<binary_block_data> denotes the binary data to be downloaded. The data length is 
from 4 Bytes (2 pts) to 32768 Bytes (16 kpts). <binary_block_data> is a binary data 
block starts with #. For example, #516384 binary data; the number 5 behind # 
denotes that the data length information (16384) occupies 5 characters. 16384 
denotes the number of bytes of the binary data. As each waveform point 
corresponds to two bytes of binary number (the range is from 0000 to 3FFF; 0000 
and 3FFF correspond to the minimum and maximum values of the waveform 
amplitude respectively), the number of bytes must be an even number. 


<value> denotes the decimal DAC values. 0 and 16383 correspond to the minimum 
and maximum values of the waveform amplitude respectively. For example, when 
the amplitude is 5Vpp and the offset is OVpc, 0 corresponds to -2.5V and 16383 
corresponds to 2.5V. The range of the number of waveform points is from 2pts to 
16384pts. For example, 5 waveform point data are sent by the :DATA:DAC 
volatile,0,16383,8192,0,16383 command. 


After sending this command, the specified signal source channel switches to volatile 
waveform output automatically. While at the same time, the initial number of points 
is modified. Users can edit the data downloaded using this command on the 
instrument. 
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[: TRACe[<n>]]:DATA:POINts 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


[: TRACe[<n>]]:DATA:POINts volatile, <data> 
[:TRACe[<n>]]:DATA:POINts? volatile 


Set or query the initial number of points of the arbitrary waveform of the specified signal 
source channel. 


Name Type Range Default 
<n> Discrete | {1|2} 1 
<data> Integer | 1 to 16384 2 


> This command initializes the voltage value of each point on the volatile waveform to 
OuV automatically. 


> After sending this command, you can use the [:TRACe[<n>]]:DATA:VALue 
command to modify the voltage of the specified point. 


The query returns an integer between 1 and 16384. 


/*Set the initial number of points of the source 1 arbitrary 
waveform to 512*/ 
/*The query returns 512*/ 


:DATA:POINts volatile,512 


:DATA:POINts? volatile 


[:TRACe[<n>]]:DATA:POINts:INTerpolate 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


[: TRACe[<n>]]:DATA:POINts:INTerpolate <mode> 
[: TRACe[<n>]]:DATA:POINts:INTerpolate? 


Set or query the interpolation mode of the editable points of the arbitrary waveform of 
the specified signal source channel. 


Name Type Range Default 
<n> Discrete | {1]2} 1 
<mode>_ | Discrete | {LINear|OFF} OFF 


>  LINear: turn on the linear interpolation. The waveform editor connects two editable 
points using a straight line. 


> OFF: turn off the linear interpolation. The waveform editor will keep a constant 
voltage level between two editable points and create a ladder-like waveform. 


The query returns LIN or OFF. 


/*Set the interpolation mode of the source 1 arbitrary 
waveform to linear*/ 
/*The query returns LIN*/ 


:DATA:POINts:INTerpolate LIN 


:DATA:POINts:INTerpolate? 
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[: TRACe[<n>]]:DATA:VALue 


Syntax [:TRACe[<n>]]:DATA:VALue volatile, <points>,<data> 
[: TRACe[<n>]]:DATA:VALue? volatile, <points> 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


[: TRACe[<n>]]:DATA:LOAD? 


Chapter 2 Command System 


Modify or query the decimal value of the specified point in the volatile memory of the 
specified signal source. 


Name Type Range Default 
<n> Discrete {1|2} 1 
<points> Integer 1 to the initial number of points -- 
<data> Integer 0 to 16383 - 


This command is only valid when the current output is volatile waveform. 
> The initial number of points can be set by the [:TRACe[<n>]]:DATA:POINts 


command. 


>  <data> denotes the decimal value. 0 and 16383 correspond to the minimum and 
maximum values of the waveform amplitude respectively. For example, when the 
amplitude is 5Vpp and the offset is OVpc, 0 corresponds to -2.5V and 16383 
corresponds to 2.5V. 


The query returns an integer between 0 and 16383. 


:DATA:VALue volatile, 1,10 


:DATA:VALue? volatile, 1 


/*The query returns 10*/ 


Syntax [:TRACe[<n>]]:DATA:LOAD? <num> 


/*Set the first point in the source 1 volatile memory to 10*/ 


Description Read the specified data packet in the volatile memory of the specified signal source. 


Parameter 


Name Type Range Default 
<n> Discrete {1|2} 1 
<num> Integer 1 -- 


Return The query returns a binary data block. The data block header is #9000032768 followed 


Format by 32768 byte binary data. 


2-152 


MSO1000Z/DS1000Z Programming Guide 


Chapter 2 Command System RIGOL 


:-‘TIMebase Commands 


The :TIMebase commands are used to set the horizontal parameters, such as enabling the delayed sweep 
and setting the horizontal timebase mode. 
Command List: 

:TIMebase:DELay:ENABle 

:TIMebase: DELay:OFFSet 


¢ 

cd 

@ :TIMebase:DELay:SCALe 
@ :TIMebase[:MAIN]:OFFSet 
@ = :TIMebase[:MAIN]:SCALe 
@ :TIMebase:MODE 


:-TIMebase:DELay:ENABle 
Syntax :TIMebase:DELay:ENABle <bool> 
:TIMebase:DELay:ENABle? 


Description Enable or disable the delayed sweep, or query the status of the delayed sweep. 


Parameter Name Type Range Default 
<bool> Bool {{1]ON}|{0|OFF}} O|OFF 


Explanation Delayed sweep can be used to enlarge a length of waveform horizontally to view 
waveform details. 


Return Format’ The query returns 1 or 0. 


Example :TIMebase:DELay:ENABle ON /*Enable the delayed sweep*/ 
:TIMebase:DELay:ENABle? /*The query returns 1*/ 
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:-TIMebase:DELay:OFFSet 


Syntax 


Description 


Parameter 


Explanation 


Return Format 


Example 


Related 
Commands 
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:TIMebase:DELay:OFFSet <offset> 


:TIMebase: DELay:OFFSet? 


Set or query the delayed timebase offset. The default unit is s. 


Name 


Type 


Range Default 


<offset> 


Real 


-(LeftTime - DelayRange/2) to 
(RightTime - DelayRange/2) 


LeftTime = 6 x MainScale - MainOffset 

RightTime = 6 x MainScale + MainOffset 

DelayRange = 12 x DelayScale 

Wherein, MainScale is the current main timebase scale of the oscilloscope, 
MainOffset is the current main timebase offset of the oscilloscope, and DelayScale is 
the current delayed timebase scale of the oscilloscope. 


The query returns the delayed timebase offset in scientific notation. 
:TIMebase:DELay:OFFSet 0.000002 /*Set the delayed timebase offset to 2us*/ 


:TIMebase: DELay:OFFSet? 


:TIMebase[:MAIN]:SCALe 
:TIMebase[:MAIN]:OFFSet 


:TIMebase:DELay:SCALe 


/*The query returns 2.0000000e-06*/ 
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:-TIMebase:DELay:SCALe 
Syntax :TIMebase:DELay:SCALe <scale> 
:TIMebase: DELay:SCALe? 


Description Set or query the delayed timebase scale. The default unit is s/div. 


Parameter Name Type Range Default 


<scale> Real Refer to Explanation 500ns/div 


Explanation > The maximum value of <scale> is the main timebase scale currently set, and 
the minimum value is expressed as: 50/(current sample rate x amplification 
factor). 

Wherein, the amplification factor is related to the sum number (the number of 

enabled analog channels plus the number of analog channels that are set as 

trigger sources and the number of enabled digital channel groups (DO to D7; D8 
to D15). When the sum number counts as 1, the amplification factor is 10; when 
the sum number counts as 2, the amplification factor is 20; when the sum 

number counts as 3 or 4, the amplification factor is 40. 

Note: 

— If an analog channel is both enabled and set as the trigger source, the sum 
number will only be counted once. 

— If one or multiple channels in the digital channel group DO to D7 (or D8 to 
D15) are enabled, the sum number will be counted once. 

— For the pattern trigger or duration trigger, the sum number counts as 4, 
and the amplification factor is 40. 

For example, 

—_ If only CH1 is enabled currently and there is only one trigger source (CH1), 
then, the sum number counts as 1, and the amplification factor is 10. 

—_ If only CH1 is enabled currently and there is only one trigger source (CH2), 
then, the sum number counts as 2, and the amplification factor is 20. 

— If CH1, CH2, and DO to D7 are enabled currently; and there are two trigger 
sources (CH1 and CH2), then, the sum number counts as 3, and the 
amplification factor is 40. 

— If CH1, DO to D7, and D8 to D15 are enabled currently; and there is only 
one trigger source (CH2), then, the sum number counts as 4, and the 
amplification factor is 40. 


> The delayed timebase scale can only be the maximum value or the value 
decreased from the maximum value in 1-2-5 step. If the minimum value 
calculated by the expression mentioned above is not a settable value, the larger 
settable value that is nearest to the calculated value will be used as the 
minimum value. 


> For example, if the following conditions are met: 
The current main timebase scale is set to 50ms/div; the sample rate is 10MSa/s; 
only CH1 and CH2 are enabled; and there is only one trigger source (CH2). 
It can be concluded that the amplification factor is 20. The maximum value of 
<scale> is 50ms/div. The minimum value is calculated using the above 
expression: 50/(10M x 20) = 2.5e-7, namely 250ns/div. As 250ns/div is not a 
settable value, take the larger settable value that is nearest to the calculated 
value, namely the minimum value is 500ns/div. 


Return Format The query returns the delayed timebase scale in scientific notation. 


Example :TIMebase:DELay:SCALe 0.00000005 /*Set the delayed timebase scale to 
50ns/div*/ 
:TIMebase: DELay:SCALe? /*The query returns 5.0000000e-08*/ 
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Related :TiMebase[:MAIN]:SCALe 


Commands :ACQuire:SRATe? 


:TRIGger: MODE 


:-TIMebase[:MAIN]:OFFSet 
Syntax :TIMebase[:MAIN]:OFFSet <offset> 
:TIMebase[:MAIN]:OFFSet? 


Description Set or query the main timebase offset. The default unit is s. 


Parameter Name Type | Range Default 


<offset> Real Refer to Explanation 0 


Explanation > The range of <offset> is related to the current mode of the horizontal 
timebase (refer to :TIMebase:MODE) and run state of the oscilloscope. 
— YT mode 
RUN: (-0.5 x MemDepth/SampleRate) to 1s (when the horizontal 
timebase is less than 200ms/div) 
(-0.5 x MemDepth/SampleRate) to (10 x MainScale) (when the 
horizontal timebase is greater than or equal to 200ms/div, namely 
the "Slow Sweep" mode) 
STOP: (-MemDepth/SampleRate) to (1s + 0.5 x MemDepth/SampleRate) 
— Roll mode 
RUN: This command is invalid. 
STOP: (-12 x MainScale) to 0 
Wherein, MemDepth is the current memory depth of the oscilloscope, 
SampleRate is the current sample rate of the oscilloscope, and MainScale is the 
current main timebase scale of the oscilloscope. 


> When the horizontal timebase mode is YT and the horizontal timebase is 
200ms/div or larger (namely the "Slow Sweep" mode), this command is invalid 
when the oscilloscope is in the transition to the "Stop" state. 


Return Format The query returns the main timebase offset in scientific notation. 
Example :TIMebase:MAIN:OFFSet 0.0002 /*Set the main timebase offset to 20ms*/ 


:TIMebase:MAIN:OFFSet? /*The query returns 2.0000000e-04*/ 
Related :RUN 
Commands “STOP 


:ACQuire:MDEPth 
:ACQuire:SRATe? 
:TIMebase[:MAIN]:SCALe 
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:-TIMebase[:MAIN]:SCALe 


Syntax :TIMebase[:MAIN]:SCALe <scale> 
:TIMebase[:MAIN]:SCALe? 


Description Set or query the main timebase scale. The default unit is s/div. 


Parameter Name Type Range Default 
YT mode: 5ns/div to 50s/div in 1-2-5 step : 
<scale> | Real Roll mode: 200ms/div to 50s/div in 1-2-5 step | 1HS/div 


Explanation When the horizontal timebase mode is YT and the horizontal timebase is 200ms/div 
or larger (namely the "Slow Sweep" mode), this command is invalid when the 
oscilloscope is in the transition to the "Stop" state. 


Return Format The query returns the main timebase scale in scientific notation. 
Example :TIMebase:MAIN:SCALe 0.0002 /*Set the main timebase scale to 200uUs/div*/ 


:TIMebase:MAIN:SCALe? /*The query returns 2.0000000e-04*/ 
Related :TIMebase:MODE 
Command 
:-TIMebase:MODE 


Syntax :TIMebase:MODE <mode> 
:TIMebase:MODE? 


Description Set or query the mode of the horizontal timebase. 


Parameter Name Type Range Default 
<mode> Discrete | {MAIN|XY|ROLL} MAIN 
Explanation > MAIN: YT mode 
> XY: XY mode 
> ROLL: Roll mode 
Return Format The query returns MAIN, XY, or ROLL. 


Example :TIMebase:MODE XY /*Set the horizontal timebase mode to XY*/ 
:TIMebase:MODE? /*The query returns XY*/ 


Related :TiMebase:DELay:OFFSet 
Soneniaricis :TIMebase: DELay:SCALe 
:TIMebase[:MAIN]:OFFSet 
:TIMebase[:MAIN]:SCALe 
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-TRIGger Commands 


The :TRIGger commands are used to set the trigger system of the oscilloscope. 


Command List: 
:TRIGger: MODE 
:TRIGger:COUPling 
:TRIGger:STATus? 
:TRIGger:SWEep 
:TRIGger: HOLDoff 
:TRIGger:NREJect 
:TRIGger:POSition? 
:TRIGger:EDGe 
:TRIGger:PULSe 
:TRIGger:SLOPe 
:TRIGger:VIDeo 
:TRIGger:PAT Tern 
:TRIGger: DURATion 
:TRIGger: TIMeout 
:TRIGger:RUNT 
:TRIGger: WINDows 
:TRIGger:DELay 
:TRIGger:SHOLd 
:TRIGger: NEDGe 
:TRIGger:RS232 
:TRIGger: TIC 
:TRIGger:SPI 


i A A A 2 A 2 2 A A 2 A 2 A A 2 A A A A 


:TRIGger:MODE 


Syntax :TRIGger:MODE <mode> 
:TRIGger:MODE? 
Description Select or query the trigger type. 


Parameter Name Type Range Default 
{EDGE]|PULSe|RUNT|WIND|NEDG|SLOPe]VIDeo| 
<mode> | Discrete PATTern|DELay|TIMeout|DURation| SHOLd| EDGE 
RS232|TIC|SPI} 


Return The query returns EDGE, PULS, RUNT, WIND, NEDG, SLOP, VID, PATT, DEL, TIM, DUR, 
Format SHOL, RS232, IIC, or SPI. 


Example :TRIGger:MODE SLOPe /*Select slope trigger*/ 
:TRIGger:MODE? /*The query returns SLOP*/ 
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:TRIGger:COUPling 
Syntax :TRIGger:COUPling <couple> 
:TRIGger:COUPling? 
Description Select or query the trigger coupling type. 
Parameter Name Type Range Default 
<couple> | Discrete {AC|DC|LFReject| HFReject} DC 
Explanation > This command is only applicable to edge trigger of which the signal source is an 
analog channel. 
> AC: block all the DC components and attenuate signals lower than 75 kHz. 
DC: allow DC and AC components into the trigger path. 
>  LFReject: block the DC components and reject the low frequency components (lower 
than 75 kHz). 
> HFReject: reject the high frequency components (higher than 75 kHz). 
Return The query returns AC, DC, LFR, or HFR. 
Format 
Example :TRIGger:COUPling LFReject /*Set the trigger coupling type to low-frequency 
rejection*/ 
:TRIGger:COUPling? /*The query returns LFR*/ 
:-TRIGger:STATus? 
Syntax :TRIGger:STATus? 
Description Query the current trigger status. 
Return The query returns TD, WAIT, RUN, AUTO, or STOP. 
Format 
:-TRIGger:SWEep 
Syntax :TRIiGger:SWEep <sweep> 
:TRIGger:SWEep? 
Description Set or query the trigger mode. 
Parameter Name Type Range Default 
<sweep>__| Discrete {AUTO|NORMal|SINGle} AUTO 


Explanation 


Return 
Format 


Example 


> AUTO: auto trigger. No matter whether the trigger condition is met, there is always 
waveform display. 


> NORMal: normal trigger. Display waveform when the trigger condition is met; 
otherwise, the oscilloscope holds the original waveform and waits for the next trigger. 


>  SINGle: single trigger. The oscilloscope waits for a trigger and displays the waveform 
when the trigger condition is met and then stops. 


The query returns AUTO, NORM, or SING. 


:TRIGger:SWEep SINGle 
:TRIGger:SWEep? 


/*Select single trigger mode */ 
/*The query returns SING*/ 
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:-TRIGger:HOLDoff 
Syntax :TRIGger:HOLDoff <value> 
:TRIGger:HOLDoff? 
Description Set or query the trigger holdoff time. The default unit is s. 
Parameter Name Type Range Default 
<value>_ | Real 16ns to 10s 16ns 
Explanation > _ Trigger holdoff can be used to stably trigger the complex waveforms (such as pulse 
series). Holdoff time is the time that the oscilloscope waits before re-arming the 
trigger circuitry. The oscilloscope will not trigger until the holdoff time expires. 
> When the trigger type is video, timeout, setup/hold, Nth edge, RS232, I2C, or SPI, 
this setting will be not available. 
Return The query returns the trigger holdoff time in scientific notation. 
Format 
Example :TRIGger:HOLDoff 0.0000002 /*Set the trigger holdoff time to 200ns*/ 
:TRIGger:HOLDoff? /*The query returns 2.000000e-07*/ 
:TRIGger:NREJect 
Syntax :TRIGger:NREJect <bool> 
:TRIGger:NREJect? 
Description Enable or disable noise rejection, or query the status of noise rejection. 
Parameter Name Type Range Default 
<bool> Bool {{1]ON}|{0|OFF}} O|OFF 
Explanation > Noise rejection reduces the possibility of noise trigger. 
> This command is not available when the trigger source is a digital channel. 
Return The query returns 1 or 0. 
Format 
Example :TRIGger:NREJect ON /*Enable noise rejection*/ 
:TRIGger:NREJect? /*The query returns 1*/ 
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: TRIGger:POSition? 
Syntax :TRIGger:POSition? 


Description Query the position in the internal memory that corresponds to the waveform trigger 
position. 


Return The query returns an integer. 
Rapmniat >  -2 denotes that the instrument is not triggered and there is no trigger position. 
>  -1 denotes the instrument is triggered outside the internal memory; namely, at this 
point, users cannot set the instrument to read the data in the internal memory 
starting from the trigger position. 


> An integer that is greater than 0 denotes that the return value is the position in the 
internal memory that corresponds to the trigger position. 


Example :TRIGger:POSition? /*The query returns 100*/ 
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:TRIGger:EDGe 


Command List: 


@ :TRIGger:EDGe:SOURce 


@ :TRIGger:EDGe:SLOPe 


@ :TRIGger:EDGe:LEVel 


:TRIGger:EDGe:SOURCe 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


:TRIGger:EDGe:SOURce <source> 
:TRIGger:EDGe:SOURce? 


Set or query the trigger source in edge trigger. 


Name Type Range Default 
{D0|D1|D2|D3|D4|D5|D6|D7|D8| 

<source> | Discrete | D9|D10]D11]D12|D13|]D14|D15| CHANnelt1 
CHANnel1|CHANnel2|CHANnel3|CHANnel4|AC} 


When one or more of channels DO to D7 is turned on, CH4 cannot be selected; when one 
or more of D8 to D15 is turned on, CH3 cannot be selected. 

The query returns DO, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, 
D1i5, CHAN1, CHAN2, CHAN3, CHAN4, or AC. 


:TRIGger:EDGe:SOURce CHANnel1i /*Set the trigger source to CH1i*/ 
:TRIGger:EDGe: SOURce? /*The query returns CHAN1*/ 


:TRIGger:EDGe:SLOPe 


Syntax 


Description 


Parameter 


Explanation 


:TRIGger:EDGe:SLOPe <slope> 
:TRIGger:EDGe:SLOPe? 

Set or query the edge type in edge trigger. 
Type 
Discrete 


Default 
POSitive 


Name Range 


{POSitive| NEGative] RFALI} 


<slope> 


POSitive: rising edge 
NEGative: falling edge 
RFALI: rising/falling edge 


Return The query returns POS, NEG, or RFAL. 
Format 
Example :TRIGger:EDGe:SLOPe NEGative /*Set the edge type to falling edge*/ 
:TRIGger:EDGe:SLOPe? /*The query returns NEG*/ 
Related :TRIGger:MODE 
Command 
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:TRIGger:EDGe:LEVel 
Syntax :TRIGger:EDGe:LEVel <level> 
:TRIGger:EDGe:LEVel? 


Description Set or query the trigger level in edge trigger. The unit is the same as the current 
amplitude unit of the signal source selected. 


Parameter Name Type | Range Default 


(-5 x VerticalScale - OFFSet) to 
(5 x VerticalScale - OFFSet) 


Explanation > _ For VerticalScale, refer to the :CHANnel<n>:SCALe command. For OFFSet, refer to 
the :CHANnel<n>:OFFSet command. 


> This command is only available when the signal source is an analog channel. 


<level> Real 0 


Return The query returns the trigger level in scientific notation. 
Format 


Example :TRIGger:EDGe:LEVel 0.16 /*Set the trigger level to 160mV*/ 
:TRIGger:EDGe:LEVel? /*The query returns 1.600000e-01*/ 
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:-TRIGger:PULSe 


Command List: 
: TRIGger: PULSe: SOURce 
:TRIGger:PULSe: WHEN 


od 
¢ 
@ :TRIGger:PULSe:WIDTh 
@ :TRIGger:PULSe:UWIDth 
¢ 
¢ 


:TRIGger:PULSe:LWIDth 
:TRIGger:PULSe:LEVel 


:TRIGger:PULSe:SOURCce 
Syntax :TRIGger:PULSe:SOURce <source> 
:TRIGger: PULSe: SOURce? 


Description Set or query the trigger source in pulse width trigger. 


Parameter Name Type Range Default 
{D0|D1|D2|D3]D4|D5|D6|D7|D8| 
<source> | Discrete D9|D10]D11]D12|D13|D14|D15| CHANnelt1 
CHANnel1|CHANnel2|CHANnel3|CHANnel4} 


Explanation When one or more of channels DO to D7 is turned on, CH4 cannot be selected; when one 
or more of D8 to D15 is turned on, CH3 cannot be selected. 


Return The query returns DO, Di, D2, D3, D4, D5, D6, D7, D8, DI, D10, D11, D12, D13, D14, 
Format D15, CHAN1, CHAN2, CHAN3, or CHAN4. 


Example :TRIGger:PULSe:SOURce CHANnel1i /*Set the trigger source to CH1i*/ 
:TRIGger: PULSe: SOURce? /*The query returns CHAN1*/ 
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:TRIGger:PULSe:WHEN 
Syntax :TRIGger:PULSe:WHEN <when> 
:TRIGger:PULSe: WHEN? 


Description Set or query the trigger condition in pulse width trigger. 


Parameter Name Type Range Default 


{PGReater|PLESs| NGReater| 
NLESs|PGLess|NGLess} 


Explanation > PGReater/PLESs: you need to specify a pulse width (refer 
to :TRIGger:PULSe:WIDTh). The oscilloscope triggers when the positive pulse width 
of the input signal is greater/lower than the specified Pulse Width. 


<when> | Discrete PGReater 


> NGReater/NLESs: you need to specify a pulse width (refer 
to :TRIGger:PULSe:WIDTh). The oscilloscope triggers when the negative pulse width 
of the input signal is greater/lower than the specified Pulse Width. 


> PGLess/NGLess: you need to specify an upper (refer to :TRIGger:PULSe: UWIDth) 
and a lower (refer to :TRIGger: PULSe:_LWIDth) pulse width. The oscilloscope triggers 
when the positive/negative pulse width of the input signal is greater than the 
specified lower pulse width and lower than the upper pulse width. 


Return The query returns PGR, PLES, NGR, NLES, PGL, or NGL. 
Format 


Example :TRIGger:PULSe:WHEN NLESs /*Set the trigger condition to NLESs*/ 
:TRIGger:PULSe: WHEN? /*The query returns NELS*/ 


:TRIGger:PULSe:WIDTh 
Syntax :TRIGger:PULSe:WIDTh <width> 
:TRIGger:PULSe:WIDTh? 


Description Set or query the pulse width in pulse width trigger. The default unit is s. 


Parameter Name Type Range Default 


PGReater, NGReater: lus 
PLESs, NLESs: 2us 


<width> | Real 8ns to 10s 


Explanation This command is available when the trigger condition (refer to :TRIGger:PULSe: WHEN) is 
PGReater, PLESs, NGReater, and NLESs. 


Return The query returns the pulse width in scientific notation. 
Format 


Example :TRIGger:PULSe:WIDTh 0.000003 /*Set the pulse width to 3us*/ 
:TRIGger:PULSe:WIDTh? /*The query returns3.000000e-06*/ 
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:TRIGger:PULSe:UWIDth 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


Related 
Command 


:TRIGger:PULSe:UWIDth <width> 
:TRIGger:PULSe: UWIDth? 
Set or query the upper pulse width in pulse width trigger. The default unit is s. 


Name Type Range Default 
<width> Real 16ns to 10s 2US 


This command is available when the trigger condition (refer to :TRIGger:PULSe: WHEN) is 
PGLess and NGLess. 


The query returns the upper pulse width in scientific notation. 


:TRIGger:PULSe:UWIDth 0.000003 /*Set the upper pulse width to 3yus*/ 
:TRIGger:PULSe: UWIDth? /*The query returns3.000000e-06*/ 


:TRIGger:PULSe:LWIDth 


:TRIGger:PULSe:LWIDth 


Syntax 


Description 


Parameter 


Explanation 


:TRIGger:PULSe:LWIDth <width> 
:TRIGger:PULSe:LWIDth? 


Set or query the lower pulse width in pulse width trigger. The default unit is s. 


Name Type Range Default 
<width> Real 8ns to 9.99s ius 


This command is available when the trigger condition (refer to :TRIGger:PULSe: WHEN) is 
PGLess and NGLess. 


Return The query returns the lower pulse width in scientific notation. 
Format 
Example :TRIGger:PULSe:LWIDth 0.000003 /*Set the lower pulse width to 3us*/ 
:TRIGger:PULSe:LWIDth? /*The query returns 3.000000e-06*/ 
Related :TRIGger:PULSe:UWIDth 
Command 
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:TRIGger:PULSe:LEVel 
Syntax :TRIGger:PULSe:LEVel <level> 
:TRIGger:PULSe:LEVel? 


Description Set or query the trigger level in pulse width trigger. The unit is the same as the current 
amplitude unit. 


Parameter Name Type | Range Default 


(-5 x VerticalScale - OFFSet) to 
(5 x VerticalScale - OFFSet) 


Explanation > _ For VerticalScale, refer to the :CHANnel<n>:SCALe command. For OFFSet, refer to 
the :CHANnel<n>:OFFSet command. 


> This command is only available when the signal source is an analog channel. 


<level> Real 0 


Return The query returns the trigger level in scientific notation. 
Format 


Example :TRIGger:PULSe:LEVel 0.16 /*Set the trigger level to 160mV*/ 
:TRIGger:PULSe:LEVel? /*The query returns 1.600000e-01*/ 
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:TRIGger:SLOPe 


Command List: 
:TRIGger:SLOPe:SOURce 
:TRIGger:SLOPe: WHEN 
:TRIGger:SLOPe: TIME 
:TRIGger:SLOPe: TUPPer 
:TRIGger:SLOPe: TLOWer 
:TRIGger:SLOPe: WINDow 


:TRIGger:SLOPe:ALEVel 
:TRIGger:SLOPe:BLEVel 


Si A A A A A A 


:TRIGger:SLOPe:SOURCce 


Syntax :TRIGger:SLOPe:SOURce <source> 
:TRIGger:SLOPe:SOURce? 


Description Set or query the trigger source in slope trigger. 


Parameter Name 


Type 


Range 


Default 


<source> 


Discrete 


{CHANnel1|CHANnel2| CHANnel3|CHANnel4} CHANnel1 


Return The query returns CHAN1, CHAN2, CHAN3, or CHAN4. 


Format 


Example :TRIGger:SLOPe:SOURce CHANnel2 
:TRIGger:SLOPe:SOURce? 


/*Set the trigger source to CH2*/ 
/*The query returns CHAN2*/ 
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:TRIGger:SLOPe:WHEN 
Syntax :TRIGger:SLOPe:WHEN <when> 
:TRIGger:SLOPe: WHEN? 


Description Set or query the trigger condition in slope trigger. 


Parameter Name Type Range Default 


{PGReater|PLESs|NGReater| 
NLESs|PGLess|NGLess} 


Explanation > PGReater/PLESs: you need to specify a time value (refer to :TRIGger:SLOPe: TIME). 
The oscilloscope triggers when the positive slope time of the input signal is 
greater/lower than the specified time. 


> NGReater/NLESs: you need to specify a time value (refer to : TRIGger:SLOPe: TIME). 
The oscilloscope triggers when the negative slope time of the input signal is 
greater/lower than the specified time. 


<when> | Discrete PGReater 


> PGLess/NGLess: you need to specify an upper limit (refer 
to :TRIGger:SLOPe:TUPPer) and a lower limit (refer to :TRIGger:SLOPe:TLOWer) of 
the time. The oscilloscope triggers when the positive/negative slope time of the input 
signal is greater than the specified lower limit and lower than the specified upper 


limit. 
Return The query returns PGR, PLES, NGR, NLES, PGL, or NGL. 
Format 
Example :TRIGger:SLOPe:WHEN NLESs /*Set the trigger condition to NLESs*/ 
:TRIGger:SLOPe: WHEN? /*The query returns NLES*/ 


:TRIGger:SLOPe: TIME 
Syntax :TRIGger:SLOPe:TIME <time> 
:TRIGger:SLOPe: TIME? 


Description Set or query the time value in slope trigger. The default unit is s. 


Parameter Name Type Range Default 


PGReater, NGReater: lus 
PLESs, NLESs: 2us 


<time> Real 8ns to 10s 


Explanation This command is available when the trigger condition (refer to :TRIGger:SLOPe: WHEN) is 
PGReater, PLESs, NGReater, and NLESs. 


Return The query returns the time value in scientific notation. 
Format 


Example :TRIGger:SLOPe:TIME 0.000003 /*Set the time value to 3yus*/ 
:TRIGger:SLOPe: TIME? /*The query returns 3.000000e-06*/ 
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:TRIGger:SLOPe:TUPPer 
Syntax :TRIGger:SLOPe:TUPPer <time> 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


Related 
Command 


:TRIGger:SLOPe:TUPPer? 


Set or query the upper limit of the time in slope trigger. The default unit is s. 


Name Type Range Default 


<time> Real 16ns to 10s 2uUS 


This command is available when the trigger condition (refer to :TRIGger:SLOPe: WHEN) is 
PGLess and NGLess. 


The query returns the upper limit of the time in scientific notation. 


:TRIGger:SLOPe:TUPPer 0.000003 /*Set the upper limit of the time to 3us*/ 
:TRIGger:SLOPe:TUPPer? /*The query returns 3.000000e-06*/ 


:TRIGger:SLOPe: TLOWer 


:TRIGger:SLOPe:TLOWer 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


Related 
Command 


:TRIGger:SLOPe:TLOWer <time> 
:TRIGger:SLOPe:TLOWer? 


Set or query the lower limit of the time in slope trigger. The default unit is s. 


Name Type Range Default 


<time> Real 8ns to 9.99s lus 


This command is available when the trigger condition (refer to :TRIGger:SLOPe: WHEN) is 
PGLess and NGLess. 


The query returns the lower limit of the time in scientific notation. 


:TRIGger:SLOPe: TLOWer 0.000000020 /*Set the lower limit of the time to 20ns*/ 
:TRIGger:SLOPe:TLOWer? /*The query returns 2.000000e-08*/ 


:TRIGger:SLOPe:TUPPer 
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:TRIGger:SLOPe:WINDow 
Syntax :TRIGger:SLOPe:WINDow <window> 
:TRIGger:SLOPe: WINDow? 


Description Set or query the vertical window type in slope trigger. 


Parameter Name Type Range Default 
<window> | Discrete | {TA|TB|TAB} TA 


Explanation > _ TA: only adjust the upper limit of the trigger level, refer to :TRIGger:SLOPe:ALEVel. 
> TB: only adjust the lower limit of the trigger level, refer to : TRIGger:SLOPe:BLEVel. 


> TAB: adjust the upper and lower limits of the trigger level at the same time, refer 
to :TRIGger:SLOPe:ALEVel and :TRIGger:SLOPe:BLEVel. 


Return The query returns TA, TB, or TAB. 
Format 


Example :TRIGger:SLOPe:WINDow TB /*Set the vertical window type to TB*/ 
:TRIGger:SLOPe:WINDow? /*The query returns TB*/ 


:TRIGger:SLOPe:ALEVel 
Syntax :TRIGger:SLOPe:ALEVel <level> 
:TRIGger:SLOPe:ALEVel? 


Description Set or query the upper limit of the trigger level in slope trigger. The unit is the same as the 
current amplitude unit. 


Parameter Name Type Range Default 


(-5 x VerticalScale - OFFSet) to 
(5 x VerticalScale - OFFSet) 


Explanation For VerticalScale, refer to :CHANnel<n>:SCALe. For OFFSet, refer 
to :CHANnel<n>:OFFSet. 


Return The query returns the upper limit of the trigger level in scientific notation. 


<level> Real 2V 


Format 
Example :TRIGger:SLOPe:ALEVel 0.16 /*Set the upper limit of the trigger level to 160mV*/ 
:TRIGger:SLOPe:ALEVel? /*The query returns 1.600000e-01*/ 
Related :TRIGger:SLOPe:BLEVel 


Command 
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:TRIGger:SLOPe: BLEVel 
Syntax :TRIGger:SLOPe:BLEVel <level> 
:TRIGger:SLOPe:BLEVel? 


Description Set or query the lower limit of the trigger level in slope trigger. The unit is the same as the 
current amplitude unit. 


Parameter Name _ | Type | Range Default 


(-5 x VerticalScale - OFFSet) to 


level. | Real (5 x VerticalScale - OFFSet) ° 
Explanation For VerticalScale, refer to :CHANnel<n>:SCALe. For OFFSet, refer 

to :CHANnel<n>:OFFSet. 

Return The query returns the lower limit of the trigger level in scientific notation. 

Format 

Example :TRIGger:SLOPe:BLEVel 0.16 /*Set the lower limit of the trigger level to 160mV*/ 

:TRIGger:SLOPe: BLEVel? /*The query returns 1.600000e-01*/ 

Related :TRIGger:SLOPe:ALEVel 

Command 
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: TRIGger:VIDeo 


Command List: 


:TRIGger:VIDeo:SOURce 


:TRIGger:VIDeo:POLarity 


:TRIGger:VIDeo:LINE 


:TRIGger:VIDeo:STANdard 


. 4 
¢ 
@ :TRIGger:VIDeo:MODE 
Sd 
¢ 
Ad 


:TRIGger:VIDeo:LEVel 


:TRIGger: VIDeo:SOURCe 


Syntax 


Description 


Parameter 


Return 
Format 


Example 


:TRIGger:VIDeo:POLarity 


Syntax 


Description 


Parameter 


Return 
Format 


Example 


RIGOL 
:TRIGger:VIDeo:SOURce <source> 
:TRIGger:VIDeo:SOURce? 
Select or query the trigger source in video trigger. 
Name Type Range Default 
<source> Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4}_ | CHANnel1 
The query returns CHAN1, CHAN2, CHAN3, or CHAN4. 
:TRIGger:VIDeo: SOURce CHANnel2 /*Set the trigger source to CH2*/ 
:TRIGger:VIDeo:SOURce? /*The query returns CHAN2*/ 
:TRIGger:VIDeo:POLarity <polarity> 
:TRIGger:VIDeo:POLarity? 
Select or query the video polarity in video trigger. 
Name Type Range Default 
<polarity> Discrete {POSitive] NEGative} POSitive 


The query returns POS or NEG. 


:TRIGger:VIDeo:POLarity POSitive 


:TRIGger:VIDeo:POLarity? 


/*The query returns POS*/ 


/*Set or query the video polarity to positive*/ 
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:TRIGger:VIDeo: MODE 
Syntax :TRIGger:VIDeo:MODE <mode> 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


Related 
Commands 


:TRIGger:VIDeo: MODE? 
Set or query the sync type in video trigger. 


Name Type Range 


Default 


<mode> | Discrete 


{ODDField|EVENfield| LINE|ALINes} 


ALINes 


>  ODDField: trigger on the rising edge of the first ramp waveform pulse in the odd 
field. This type is available when the video standard is NTSC or PAL/SECAM. 


> EVENfield: trigger on the rising edge of the first ramp waveform pulse in the even 
field. This type is available when the video standard is NTSC or PAL/SECAM. 


> LINE: for the NTSC and PAL/SECAM video standards, trigger on the specified line in 
the odd or even field; for the 480P and 576P video standards, trigger on the specified 


line. 
>  ALINes: trigger on all the horizontal sync pulses. 
The query returns ODDF, EVEN, LINE, or ALIN. 


:TRIGger:VIDeo:MODE ODDField 
:TRIGger:VIDeo: MODE? 


:TRIGger:VIDeo:LINE 
:TRIGger:VIDeo:STANdard 


/*Set the sync type to odd field*/ 
/*The query returns ODDF*/ 


:TRIGger:VIDeo:LINE 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


Related 
Command 


:TRIGger:VIDeo:LINE <line> 
:TRIGger:VIDeo:LINE? 


Set or query the line number when the sync type in video trigger is LINE. 


Name Type Range 


Default 


<line> Integer Refer to Explanation 


1 


> NTSC: 1 to 525 
>  PAL/SECAM: 1 to 625 
> 480P: 1 to 525 
> 576P: 1 to 625 


The query returns an integer. 


:TRIGger:VIDeo:LINE 100 
:TRIGger:VIDeo:LINE? 


:TRIGger:VIDeo:MODE 


/*Set the line number to 100*/ 
/*The query returns 100*/ 
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:TRIGger: VIDeo:STANdard 
Syntax :TRIGger:VIDeo:STANdard <standard> 
:TRIGger:VIDeo:STANdard? 


Description Set or query the video standard in video trigger. 


Parameter Name Type Range Default 
<standard> | Discrete | {PALSecam|NTSC|480P|576P} NTSC 


Explanation > PALSecam: 
PAL: the frame frequency is 25 frames per second. The TV sweep line is 625 with the 
odd field goes first and the even field follows behind. 
SECAM: the frame frequency is 25 frames per second. The TV sweep line is 625 with 
interlacing sweep. 


> NTSC: the field frequency is 60 fields per second and the frame frequency is 30 
frames per second. The TV sweep line is 525 with the even field goes first and the 
odd field follows behind. 


>  480P: the frame frequency is 60 frames per second; the TV sweep line is 525; 
line-by-line sweep; the line frequency is 31.5 kHz. 


>  576P: the frame frequency is 60 frames per second; the TV sweep line is 625; 
line-by-line sweep. 
Return The query returns PALS, NTSC, 480P, or 576P. 
Format 
Example :TRIGger:VIDeo:STANdard NTSC /*Select NTSC video standard*/ 
:TRIGger:VIDeo:STANdard? /*The query returns NTSC*/ 
Related :TRiGger:VIDeo:LINE 
Commands  terGger:VIDeo:MODE 


:TRIGger:VIDeo:LEVel 
Syntax :TRIGger:VIDeo:LEVel <level> 
:TRIGger:VIDeo:LEVel? 


Description Set or query the trigger level in video trigger. The unit is the same as the current 
amplitude unit. 


Parameter Name Type Range Default 


(-5 x VerticalScale - OFFSet) to 
(5 x VerticalScale - OFFSet) 


Explanation For VerticalScale, refer to :CHANnel<n>:SCALe. For OFFSet, refer 
to :CHANnel<n>:OFFSet. 


Return The query returns the trigger level in scientific notation. 
Format 


Example :TRIGger:VIDeo:LEVel 0.16 /*Set the trigger level to 160mV*/ 
:TRIGger:VIDeo:LEVel? /*The query returns 1.600000e-01*/ 


<level> Real 0 
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:TRIGger:PATTern 


Command List: 
@ :TRIGger:PATTern:PATTern 
@ :TRIGger:PATTern:LEVel 


2-176 MSO1000Z/DS1000Z Programming Guide 


Chapter 2 Command System RIGOL 


:TRIGger:PATTern:PATTern 


Syntax :TRIGger:PATTern:PATTern <pa_ch1>[,<pa_ch2>[,<pa_ch3> 
[,<pa_ch4>[,<pa_d0>...[,<pa_d15>]]]]] 


:TRIGger:PATTern:PATTern? 


Description Set or query the pattern of each channel in pattern trigger. 


Parameter Name Type Range Default 
<pa_chi> Discrete {H|L|X|R|F} Xx 
<pa_ch2> Discrete {H|L|X|R|F} Xx 
<pa_ch3> Discrete {H|L|X|R|F} us 
<pa_ch4> Discrete {H|L|X|RIF} X 
<pa_d0> Discrete {H|L|X|R|F} X 
<pa_di5> Discrete {H|L|X|R|F} Xx 


Explanation > 


> 


<pa_chi> to <pa_ch4> set the patterns of analog channels CH1 to CH4. <pa_d0> 
to <pa_di5> set the patterns of digital channels DO to D15. 


Users can send 20 parameters to set the pataterns of all the channels. Users can also 
omit some parameters to set the patterns of some of the channels (the pattern states 
of the channels of which the parameters are omitted remains unchanged), but at 
least one parameter (this parameter sets the pattern of CH1) should be sent. When 
the number of parameters sent is less than 20, the instrument sets the channels in 
CH1 to CH4 and DO to D15 order. 


In the range of the parameter, H represents high level (higher than the threshold 
level of the channel). L represents low level (lower than the threshold level of the 
channel). X denotes that this channel is ignored (this channel is not used as a part of 
the pattern. When all the channels in the pattern are set to X, the oscilloscope will not 
trigger). R represents the rising edge and F represents the falling edge (in the 
pattern, only a single rising edge or falling edge can be defined. If an edge item is 
currently defined and then another edge item is defined in another channel in the 
pattern, the former edge item defined will be replaced by X). 


Please distinguish "omit parameter" from "ignore channel". The former means that 
the parameters corresponding to some channels are not sent when sending the 
command and the pattern states of these channels remain unchanged. The latter 
means that the channel is set to X when sending the command and the state of this 
channel is ignored when the instrument judges the patterns. 


The query returns the patterns of the 4 analog channels when all the digital channels 
are turned off; the query returns the patterns of all the 20 channels when any of the 
digital channels is turned on. 


Return The query returns the patterns of the 4 analog channels or all the channels. The patterns 
Format of multiple channels are separated by commas. 


Example :TRIGger:PATTern:PATTern H,R,L,X /*Set the patterns of CH1 to CH4 to H,R,L,X. The 


patterns of the other channels remain unchanged*/ 


:TRIGger:PATTern:PAT Tern? /*The query returns 


HR,LiX,X,XpXXpXpXpXpKpXpX KK KK */ 
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:TRIGger:PATTern:LEVel 
Syntax :TRIGger:PATTern:LEVel <chan>,<level> 
:TRIGger:PAT Tern:LEVel? <chan> 


Description Set or query the trigger level of the specified channel in pattern trigger. The unit is the 
same as the current amplitude unit. 


Parameter Name _ | Type Range Default 
<chan>_ | Discrete | {CHANneli|CHANnel2|CHANnel3|CHANnel4} CHANnel1 


(-5 x VerticalScale - OFFSet) to 
(5 x VerticalScale - OFFSet) 


Explanation > _ For VerticalScale, refer to :CHANnel<n>:SCALe. For OFFSet, refer 
to :CHANnel<n>:OFFSet. 


<level> | Real 0 


> This command is only available when the signal source is an analog channel. 


Return The query returns the trigger level in scientific notation. 
Format 


Example :TRIGger:PATTern:LEVel CHANnel2,0.16 /*Set the trigger level of CH2 to 160mV*/ 
:TRIGger:PATTern:LEVel? CHANnel2 /*The query returns 1.600000e-01*/ 
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:-TRIGger:DURATion 


Command List: 


@ :TRIGger: DURATion:SOURCce 


:TRIGger: DURATion: TYPe 


:TRIGger: DURATion: WHEN 
:TRIGger: DURATion: TUPPer 


¢¢¢ ¢ 


:TRIGger: DURATion: TLOWer 


:TRIGger:DURATion:SOURce 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


RIGOL 
:TRIGger: DURATion:SOURce <source> 
:TRIGger: DURATion: SOURCce? 
Set or query the trigger source in duration trigger. 
Name Type Range Default 
{D0|D1|D2|D3|D4|D5|D6|D7|D8| 
<source> | Discrete D9|D10|D11|D12|D13|D14|D15]| CHANnel1i 
CHANnel1 | CHANnel2|CHANnel3|CHANnel4} 


When one or more of channels DO to D7 is turned on, CH4 cannot be selected; when one 
or more of D8 to D15 is turned on, CH3 cannot be selected. 


The query returns DO, D1, D2, D3, D4, D5, D6, D7, D8, DI, D10, D11, D12, D13, D14, 
D15, CHAN1, CHAN2, CHAN3, or CHAN4. 


:TRIGger: DURATion: SOURce CHANnel2 
:TRIGger: DURATion: SOURCce? 


/*Set the trigger source to CH2*/ 
/*The query returns CHAN2*/ 
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:TRIGger:DURATion:TYPe 


Syntax :TRIGger:DURATion:TYPe <type_chi>[,<type_ch2>[,<type_ch3> 
[,<type_ch4>[,<type_d0>...[,<type_d15>]]]]] 


:TRIGger: DURATion: TYPe? 


Description Set or query the pattern of each channel in duration trigger. 


Parameter Name Type Range Default 
<type_chi> Discrete | {H|L|X} X 
<type_ch2> Discrete | {H|L|X} X 
<type_ch3> Discrete | {H|L|X} X 
<type_ch4> Discrete | {H|L|X} X 
<type_d0> Discrete | {H|L|X} X 
<type_di5> | Discrete | {H|L|X} X 


Explanation > <type_chi> to <type_ch4> set the patterns of analog channels CH1 to CH4. 
<type_d0> to <type_di5> set the patterns of digital channels DO to D15. 


> Users can send 20 parameters to set the pataterns of all the channels. Users can also 
omit some parameters to set the patterns of some of the channels (the pattern states 
of the channels of which the parameters are omitted remains unchanged), but at 
least one parameter (this parameter sets the pattern of CH1) should be sent. When 
the number of parameters sent is less than 20, the instrument sets the channels in 
CH1 to CH4 and DO to D15 order. 


> In the range of the parameter, H represents high level (higher than the threshold 
level of the channel). L represents low level (lower than the threshold level of the 
channel). X denotes that this channel is ignored (this channel is not used as a part of 
the pattern. When all the channels in the pattern are set to X, the oscilloscope will not 
trigger). 


> Please distinguish "omit parameter" from "ignore channel". The former means that 
the parameters corresponding to some channels are not sent when sending the 
command and the pattern states of these channels remain unchanged. The latter 
means that the channel is set to X when sending the command and the state of this 
channel is ignored when the instrument judges the patterns. 


> The query returns the patterns of the 4 analog channels when all the digital channels 
are turned off; the query returns the patterns of all the 20 channels when any of the 
digital channels is turned on. 


Return The query returns the patterns of the 4 analog channels or all the channels. The patterns 
Format of multiple channels are separated by commas. 


Example :TRIGger:DURATion:TYPe L,X,H,L /*Set the patterns of CH1 to CH4 to L,X,H,L. The 
patterns of the other channels remain unchanged*/ 
:TRIGger: DURATion: TYPe? /*The query returns 
LX, H,L,X,XX,XXXpXXpXpXXpXXKp pK A/ 


2-180 MSO1000Z/DS1000Z Programming Guide 


Chapter 2 Command System 


:TRIGger:DURATion:WHEN 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


RIGOL 
:TRIGger:DURATion:WHEN <when> 
:TRIGger: DURATion: WHEN? 
Set or query the trigger condition in duration trigger. 
Name Type Range Default 
<when>_| Discrete {GREater|LESS|GLESs} GREater 


>  GREater: you need to specify a time (refer to :TRIGger: DURATion: TLOWer). The 
oscilloscope triggers when the duration of the pattern is greater than the preset time. 


> LESS: you need to specify a time (refer to :TRIGger: DURATion:TUPPer). The 
oscilloscope triggers when the duration of the pattern is lower than the preset time. 


>  GLESs: you need to specify an upper limit of the time (refer 
to :TRIGger:DURATion:TUPPer) and lower limit of the time (refer 
to :TRIGger:DURATion:TLOWer). The oscilloscope triggers when the duration of the 
pattern is lower than the preset upper limit of the time and greater than the preset 
lower limit of the time. 


The query returns GRE, LESS, or GLES. 


:TRIGger: DURATion:WHEN LESS 
:TRIGger: DURATion: WHEN? 


/*Set the trigger condition to <*/ 
/*The query returns LESS*/ 


:TRIGger:DURATion:TUPPer 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


Related 
Command 


:TRIGger: DURATion:TUPPer <NR3> 
:TRIGger: DURATion:TUPPer? 


Set or query the duration time upper limit in duration trigger. The default unit is s. 


Name Type Range Default 
Related to the trigger condition 

<NR3> Real LESS: 8ns to 10s 2US 
GLESs: 16ns to 10s 


This command is available when the trigger condition (: TRIGger: DURATion: WHEN) is 
LESS or GLESs. 


The query returns the duration time upper limit in scientific notation. 


:TRIGger: DURATion: TUPPer 0.000003 
:TRIGger: DURATion:TUPPer? 


:TRIGger: DURATion: TLOWer 


/*Set the duration time upper limit to 3yus*/ 
/*The query returns 3.000000e-06*/ 
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:TRIGger:DURATion:TLOWer 
Syntax :TRIGger:DURATion:TLOWer <NR3> 
:TRIGger: DURATion: TLOWer? 


Description Set or query the duration time lower limit in duration trigger. The default unit is s. 


Parameter Name Type Range Default 
<NR3> Real 8ns to 9.99s ius 
Explanation This command is available when the trigger condition (: TRIGger: DURATion: WHEN) is 
GREater or GLESs. 
Return The query returns the duration time lower limit in scientific notation. 
Format 
Example :TRIGger:DURATion:TLOWer 0.000003 /*Set the duration time lower limit to 3yus*/ 
:TRIGger: DURATion: TLOWer? /*The query returns 3.000000e-06*/ 
Related :TRIGger:DURATion:TUPPer 
Command 
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: TRIGger:TIMeout 
Command List: 
@ :TRIGger:TiMeout:SOURce 
@ :TRIGger: TiMeout:SLOPe 
@ :TRIGger:TiMeout:TIMe 
:TRIGger:TIMeout:SOURCce 
Syntax :TRIGger:TIMeout:SOURce <source> 
:TRIGger:TIMeout:SOURce? 
Description Set or query the trigger source in timeout trigger. 
Parameter Name Type Range Default 
{D0|D1|D2|D3|D4|D5|D6|D7|D8| 
<source> Discrete D9|D10|D11|D12|D13|D14|D15| CHANnel1 
CHANnel1|CHANnel2|CHANnel3|CHANnel4} 


Explanation 


Return 
Format 


Example 


When one or more of channels DO to D7 is turned on, CH4 cannot be selected; when one 
or more of D8 to D15 is turned on, CH3 cannot be selected. 


The query returns DO, D1, D2, D3, D4, D5, D6, D7, D8, DI, D10, D11, D12, D13, D14, 
D15, CHAN1, CHAN2, CHAN3, or CHAN4. 


:TRIGger:TIMeout:SOURce CHANnel2 
:TRIGger:TIMeout:SOURce? 


/*Set the trigger source to CH2*/ 
/*The query returns CHAN2*/ 


:TRIGger:TIMeout:SLOPe 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


:TRIGger:TIMeout:SLOPe <slope> 
:TRIGger:TIMeout:SLOPe? 

Set or query the edge type in timeout trigger. 
Type 
Discrete 


Name Range Default 
{POSitive] NEGative] RFALI} POSitive 


>  POSitive: start timing when the rising edge of the input signal passes through the 
trigger level. 


<slope> 


> NEGative: start timing when the falling edge of the input signal passes through the 
trigger level. 


> RFALI: start timing when any edge of the input signal passes through the trigger 
level. 


The query returns POS, NEG, or RFAL. 


:TRIGger:TIMeout:SLOPe NEGative 
:TRIGger:TIMeout:SLOPe? 


/*Set the edge type to falling edge*/ 
/*The query returns NEG*/ 
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:TRIGger:TIMeout:TIMe 
Syntax :TRIGger:TIMeout:TIMe <NR3> 
:TRIGger: TIMeout:TIMe? 


Description Set or query the timeout time in timeout trigger. The default unit is s. 


Parameter Name Type Range Default 


<NR3> Real 16ns to 10s 16ns 


Return The query returns the timeout time in scientific notation. 
Format 


Example :TRIGger:TIMeout:TIMe 0.002 /*Set the timeout time to 2ms*/ 
:TRIGger:TIMeout:TIMe? /*The query returns 2.000000e-03*/ 
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:-TRIGger:RUNT 


Command List: 


:TRIGger: RUNT:SOURce 


:TRIGger: RUNT:POLarity 


:TRIGger: RUNT: WHEN 


:TRIGger: RUNT:WLOWer 


:TRIGger:RUNT:ALEVel 
:TRIGger:RUNT:BLEVel 


. 4 
¢ 
od 
@ :TRIGger:RUNT:WUPPer 
a 
od 
Sd 


:TRIGger:RUNT:SOURCe 
:TRIGger:RUNT:SOURce <source> 


Syntax 


Description 


Parameter 


Return 
Format 


Example 


:TRIGger:RUNT:SOURce? 


Set or query the trigger source in runt trigger. 


RIGOL 


Name Type 


Range 


Default 


<source> Discrete 


{CHANnel1|CHANnel2|CHANnel3|CHANnel4} 


CHANnel1 


The query returns CHAN1, 


:TRIGger:RUNT:SOURce CHANnel2 


:TRIGger:RUNT:SOURce? 


:TRIGger:RUNT:POLarity 
:TRIGger:RUNT:POLarity <polarity> 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


:TRIGger:RUNT:POLarity? 


CHAN2, CHAN3, or CHAN4. 


/*The query returns CHAN2*/ 


Set or query the pulse polarity in runt trigger. 


/*Set the trigger source to CH2*/ 


Name Type 


Range 


Default 


<polarity> | Discrete 


{POSitive | NEGative} 


POSitive 


> POSitive: the instrument triggers on the positive runt pulse. 


> NEGative: the instrument triggers on the negative runt pulse. 


The query returns POS or NEG. 


:TRIGger:RUNT:POLarity NEGative 


:TRIGger:RUNT:POLarity? 


/*The query returns NEG*/ 


/*Set the pulse polarity to negative*/ 
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:TRIGger:RUNT:WHEN 
Syntax :TRIGger:RUNT:WHEN <when> 
:TRIGger:RUNT: WHEN? 


Description Set or query the qualifier in runt trigger. 


Parameter Name Type Range Default 
<when> | Discrete | {NONE|GREater|LESS|GLESs} NONE 
Explanation > NONE: do not set the trigger condition in runt trigger. 


>  GREater: trigger when the runt pulse width is greater than the lower limit of the pulse 
width (refer to :TRIGger:RUNT:WLOWer). 


> LESS: trigger when the runt pulse width is lower than the upper limit of the pulse 
width (refer to :TRIGger:RUNT:WUPPer). 


>  GLESs: trigger when the runt pulse width is greater than the lower limit (refer 
to :TRIGger:RUNT:WLOWer) and lower than the upper limit of the pulse width (refer 
to :TRIGger:RUNT:WUPPer). Note: the lower limit of the pulse width must be lower 
than the upper limit. 


Return The query returns NONE, GRE, LESS, or GLES. 
Format 


Example :TRIGger:RUNT:WHEN LESS /*Set the qualifier to <*/ 
:TRIGger:RUNT: WHEN? /*The query returns LESS*/ 


:TRIGger:RUNT:WUPPer 
Syntax :TRIGger:RUNT:WUPPer <NR3> 
:TRIGger:RUNT:WUPPer? 


Description Set or query the pulse width upper limit in runt trigger. The default unit is s. 


Parameter Name Type Range Default 
When the qualifier is LESS, the range is from 8ns to 
<NR3> Real 10s; when the qualifier is GLESs, the range is from | 2us 
16ns to 10s. 


Explanation > This command is only available when the qualifier (refer to :TRIGger:RUNT:WHEN) is 
LESS or GLESs. 


> When the qualifier is GLESs, the upper limit of the pulse width must be greater than 
the lower limit of the pulse width (: TRIGger: RUNT:WLOWer). 


Return § The query returns the pulse width upper limit in scientific notation. 
Format 


Example :TRIGger:RUNT:WUPPer 0.02 /*Set the pulse width upper limit to 20ms*/ 
:TRIGger:RUNT:WUPPer? /*The query returns 2.000000e-02*/ 
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:TRIGger:RUNT:WLOWer 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


RIGOL 
:TRIGger:RUNT:WLOWer <NR3> 
:TRIGger:RUNT:WLOWer? 
Set or query the pulse width lower limit in runt trigger. The default unit is s. 
Name Type | Range Default 
When the qualifier is GREater, the range is from 8ns to 
<NR3> Real — the qualifier is GLESs, the range is from 8ns | ips 


> This command is only available when the qualifier (refer to :TRIGger:RUNT:WHEN) is 
GREater or GLESs. 


> When the qualifier is GLESs, the lower limit of the pulse width must be smaller than 
the upper limit of the pulse width (: TRIGger:RUNT:WUPPer). 


The query returns the pulse width lower limit in scientific notation. 


:TRIGger:RUNT:WLOWer 0.01 
:TRIGger:RUNT:WLOWer? 


/*Set the pulse width lower limit to 1ms*/ 
/*The query returns 1.000000e-03*/ 


:TRIGger:RUNT:ALEVel 


Syntax :TRIGger:RUNT:ALEVel <level> 
:TRIGger:RUNT:ALEVel? 
Description Set or query the trigger level upper limit in runt trigger. The unit is the same as the 
current amplitude unit. 
Parameter Name Type | Range Default 
(-5 x VerticalScale - OFFSet) to 
alevel>. || Real (5 x VerticalScale - OFFSet) ad 
Explanation For VerticalScale, refer to :CHANnel<n>:SCALe. For OFFSet, refer 
to :CHANnel<n>:OFFSet. 
Return The query returns the trigger level upper limit in scientific notation. 
Format 
Example :TRIGger:RUNT:ALEVel 0.16 /*Set the trigger level upper limit to 160mV*/ 
:TRIGger:RUNT:ALEVel? /*The query returns 1.600000e-01*/ 
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:TRIGger:RUNT:BLEVel 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


:TRIGger:RUNT:BLEVel <level> 
:TRIGger:RUNT:BLEVel? 


Set or query the trigger level lower limit in runt trigger. The unit is the same as the current 
amplitude unit. 


Name Type | Range Default 


(-5 x VerticalScale - OFFSet) to 


steve | Real (5 x VerticalScale - OFFSet) 


0 


For VerticalScale, refer to :CHANnel<n>:SCALe. For OFFSet, refer 
to :CHANnel<n>:OFFSet. 


The query returns the trigger level lower limit in scientific notation. 


:TRIGger:RUNT:BLEVel 0.16 /*Set the trigger level lower limit to 160mV*/ 
:TRIGger:RUNT:BLEVel? /*The query returns 1.600000e-01*/ 
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:TRIGger:WINDows 


Command List: 
:TRIGger: WINDows:SOQURce 
:TRIGger: WINDows:SLOPe 


. 4 
¢ 
@ :TRIGger:WINDows:POSition 
@ :TRIGger:WINDows:TIMe 
¢ 
Ad 


:TRIGger: WINDows:ALEVel 


:TRIGger: WINDows:BLEVel 


:TRIGger:WINDows:SOURce 


RIGOL 
Syntax :TRIGger:WINDows:SOURce <source> 
:TRIGger: WINDows:SOURce? 
Description Set or query the trigger source in windows trigger. 
Range Default 


Parameter Name Type 


<source> Discrete 


{CHANnel1|CHANnel2|CHANnel3|CHANnel4} CHANnel1 


Return The query returns CHAN1, CHAN2, CHAN3, or CHAN4. 


Format 


Example :TRIGger:WINDows:SOURce CHANnel2 


:TRIGger:WINDows:SOURce? 


:TRIGger:WINDows:SLOPe 


Syntax :TRIGger:WINDows:SLOPe <type> 


:TRIGger:WINDows:SLOPe? 


Description Set or query the windows type in windows trigger. 


/*Set the trigger source to CH2*/ 
/*The query returns CHAN2*/ 


Parameter Name Type 


Range 


Default 


<type> Discrete 


{POSitive| NEGative] RFALI} POSitive 


Explanation >  POSitive: trigger on the rising edge of the input signal when the voltage level is 
greater than the preset high trigger level. 


> NEGative: trigger on the falling edge of the input signal when the voltage level is 
lower than the preset low trigger level. 


>  RFALI: trigger on any edge of the input signal when the voltage level meets the 


preset trigger level. 
Return § The query returns POS, NEG, or RFAL. 


Format 


Example :TRIGger:WINDows:SLOPe NEGative 


:TRIGger: WINDows:SLOPe? 


/*Set the windows type to NEGative*/ 
/*The query returns NEG*/ 
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:TRIGger:WINDows:POSition 
Syntax :TRIGger:WINDows:POSition <pos> 
:TRIGger:WINDows:POSition? 


Description Set or query the trigger position in windows trigger. 


Parameter Name Type Range Default 
<type> | Discrete {EXIT|ENTER|TIMe} ENTER 


Explanation > _ EXIT: trigger when the input signal exits the specified trigger level range. 


> ENTER: trigger when the trigger signal enters the specified trigger level range. 


>  TIMe: used to specify the hold time of the input signal after it enters the specified 
trigger level range. The instrument triggers when the accumulated hold time equals 
the windows time. 


Return The query returns EXIT, ENTER, or TIM. 
Format 


Example :TRIGger:WINDows:POSition ENTER /*Set the trigger position to enter*/ 
:TRIGger:WINDows:POSition? /*The query returns ENTER*/ 


:TRIGger:WINDows:TIMe 
Syntax :TRIGger:WINDows:TIMe <NR3> 
:TRIGger:WINDows:TIMe? 


Description Set or query the hold time in windows trigger. 


Parameter Name Type Range Default 
<NR3> Real 8ns to 10s ius 
Return § The query returns the hold time in scientific notation. 
Format 
Example :TRIGger:WINDows:TIMe 0.002 /*Set the hold time to 2ms*/ 
:TRIGger:WINDows:TIMe? /*The query returns 2.000000e-03*/ 
Related :TRIGger:WINDows:POSition 
Command 
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:TRIGger:WINDows:ALEVel 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


:TRIGger:WINDows:BLEVel 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


:TRIGger:WINDows:ALEVel <level> 
:TRIGger: WINDows:ALEVel? 


Set or query the trigger level upper limit in windows trigger. The unit is the same as the 
current amplitude unit. 


RIGOL 


Name 


Type 


Range 


Default 


<level> 


Real 


(-5 x VerticalScale - OFFSet) to 
(5 x VerticalScale - OFFSet) 


2V 


For VerticalScale, refer to :CHANnel<n>:SCALe. For OFFSet, refer 


to :CHANnel<n>:OFFSet. 


The query returns the trigger level upper limit in scientific notation. 


:TRIGger:WINDows:ALEVel 0.16 
:TRIGger: WINDows:ALEVel? 


:TRIGger:WINDows:BLEVel <level> 
:TRIGger: WINDows:BLEVel? 


Set or query the tigger level lower limit in windows trigger. The unit is the same as the 
current amplitude unit. 


/*Set the trigger level upper limit to 160mV*/ 
/*The query returns 1.600000e-01*/ 


Name 


Type 


Range 


Default 


<level> 


Real 


(-5 x VerticalScale - OFFSet) to 
(5 x VerticalScale - OFFSet) 


0 


For VerticalScale, refer to :CHANnel<n>:SCALe. For OFFSet, refer 


to :CHANnel<n>:OFFSet. 


The query returns the tigger level lower limit in scientific notation. 


:TRIGger:WINDows:BLEVel 0.05 
:TRIGger: WINDows:BLEVel? 


/*Set the tigger level lower limit to 50mV*/ 
/*The query returns 5.000000e-02*/ 
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:TRIGger:DELay 


Command List: 
:TRIGger:DELay:SA 
:TRIGger: DELay:SLOPA 


od 

¢ 

@ :TRIGger:DELay:SB 
@ :TRIGger:DELay:SLOPB 
a 

4 

¢ 


:TRIGger: DELay: TYPe 
:TRIGger: DELay: TUPPer 
:TRIGger: DELay: TLOWer 


:TRIGger:DELay:SA 
Syntax :TRIGger:DELay:SA <Source> 
:TRIGger:DELay:SA? 


Description Set or query the trigger source A in delay trigger. 


Parameter Name Type Range Default 
<source> | Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4} | CHANnel1 
Return The query returns CHAN1, CHAN2, CHAN3, or CHAN4. 


Format 
Example :TRIGger:DELay:SA CHANnel2 /*Set the trigger source A to CH2*/ 
:TRIGger:DELay:SA? /*The query returns CHAN2*/ 
:TRIGger:DELay:SLOPA 


Syntax :TRIGger:DELay:SLOPA <slope> 
:TRIGger: DELay:SLOPA? 
Description Set or query the edge type of edge A in delay trigger. 


Parameter Name Type Range Default 
<slope> Discrete {POSitive| NEGative} POSitive 
Return The query returns POS or NEG. 
Format 
Example :TRIGger:DELay:SLOPA NEGative /*Set the edge type of edge A to falling edge*/ 


:TRIGger: DELay:SLOPA? /*The query returns NEG*/ 
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:TRIGger:DELay:SB 
Syntax :TRIGger:DELay:SB <source> 
:TRIGger:DELay:SB? 
Description Set or query the trigger source B in delay trigger. 
Parameter Name Type Range Default 
<source> | Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4}_ | CHANnel2 
Return § The query returns CHAN1, CHAN2, CHAN3, or CHAN4. 
Format 
Example :TRIGger:DELay:SB CHANnel4 /*Set the trigger source B to CH4*/ 
:TRIGger:DELay:SB? /*The query returns CHAN4*/ 
:TRIGger:DELay:SLOPB 
Syntax :TRIGger:DELay:SLOPB <slope> 
:TRIGger: DELay:SLOPB? 
Description Set or query the edge type of edge B in delay trigger. 
Parameter Name Type Range Default 
<slope>_ | Discrete {POSitive| NEGative} POSitive 
Return The query returns POS or NEG. 
Format 
Example :TRIGger:DELay:SLOPB NEGative /*Set the edge type of edge B to falling edge*/ 


:TRIGger: DELay:SLOPB? 


/*The query returns NEG*/ 
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:TRIGger:DELay:TYPe 
Syntax :TRIGger:DELay:TYPe <type> 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


Related 
Commands 


:TRIGger:DELay:TYPe? 
Set or query the delay type in delay trigger. 


Name Type Range Default 
<type> Discrete {GREater|LESS|GLESs |GOUT} GREater 


>  GREater: trigger when the time difference (AT) between the specified edges of tigger 
source A and tigger source B is greater than the preset time limit. 


> LESS: trigger when the time difference (AT) between the specified edges of tigger 
source A and tigger source B is lower than the preset time limit. 


>  GLESs: trigger when the time difference (AT) between the specified edges of tigger 
source A and tigger source B is greater than the lower limit of the preset time and 
lower than the upper limit of the preset time. Note that the time lower limit must be 
lower than the time upper limit. 


> GOUT: trigger when the time difference (AT) between the specified edges of tigger 
source A and tigger source B is lower than the lower limit of the preset time or 
greater than the upper limit of the preset time. Note that the time lower limit must be 
lower than the time upper limit. 


The query returns GOUT, GRE, LESS, or GLES. 


:TRIGger:DELay:TYPe GOUT /*Set the delay type to ><*/ 
:TRIGger:DELay:TYPe? /*The query returns GOUT*/ 


:TRIGger: DELay: TUPPer 
:TRIGger: DELay: TLOWer 


:TRIGger:DELay:TUPPer 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


Related 
Command 


:TRIGger:DELay: TUPPer <NR3> 
:TRIGger: DELay: TUPPer? 
Set or query the upper limit of the delay time in delay trigger. The default unit is s. 


Name Type Range Default 
<NR3> Real 16ns to 10s 2uUs 


This command is only available when the delay type (refer to :TRIGger:DELay:TYPe) is 
LESS, GOUT, or GLESs. 


The query returns the upper limit of the delay time in scientific notation. 


:TRIGger:DELay:TUPPer 0.002 /*Set the upper limit of the delay time to 2ms*/ 
:TRIGger:DELay: TUPPer? /*The query returns 2.000000e-03*/ 


:TRIGger: DELay: TLOWer 


2-194 


MSO1000Z/DS1000Z Programming Guide 


Chapter 2 Command System RIGOL 


:TRIGger:DELay: TLOWer 
Syntax :TRIGger:DELay:TLOWer <NR3> 
:TRIGger: DELay: TLOWer? 


Description Set or query the lower limit of the delay time in delay trigger. The default unit is s. 


Parameter Name Type Range Default 


Related to the delay type 
<NR3> Real GREater: 8ns to 10s lus 
GOUT or GLESs: 8ns to 9.99s 


Explanation This command is only available when the delay type (refer to :TRIGger: DELay:TYPe) is 
GREater, GOUT, or GLESs. 


Return The query returns the lower limit of the delay time in scientific notation. 


Format 
Example :TRIGger:DELay:TLOWer 0.002 /*Set the lower limit of the delay time to 2ms*/ 
:TRIGger: DELay: TLOWer? /*The query returns 2.000000e-03*/ 
Related :TRIGger:DELay:TUPPer 
Command 
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:-TRIGger:SHOLd 


Command List: 
:TRIGger:SHOLd:DSrc 
:TRIGger:SHOLd:CSrc 


od 

¢ 

@ :TRIGger:SHOLd:SLOPe 
@ = :TRIGger:SHOLd:PATTern 
a 
4 
¢ 


:TRIGger:SHOLd:TYPe 
:TRIGger:SHOLd:STIMe 
:TRIGger: SHOLd:HTIMe 


:TRIGger:SHOLd:DSrc 
Syntax :TRIGger:SHOLd:DSrc <source> 
:TRIGger:SHOLd:DSrc? 


Description Set or query the data source in setup/hold trigger. 


Parameter Name Type Range Default 
<source> | Discrete | {CHANnel1|CHANnel2|CHANnel3|CHANnel4} CHANnel1 
Return The query returns CHAN1, CHAN2, CHAN3, or CHAN4. 


Format 
Example :TRIGger:SHOLd:DSrc CHANnel1i /*Set the data source to CH1*/ 
:TRIGger:SHOLd:DSrc? /*The query returns CHAN1*/ 
:TRIGger:SHOLd:CSrc 


Syntax :TRIGger:SHOLd:CSrc <source> 
:TRIGger:SHOLd:CSrc? 


Description Set or query the clock source in setup/hold trigger. 


Parameter Name Type Range Default 


<source> | Discrete {CHANnel1|CHANnel2|CHANnel3|CHANnel4} CHANnel2 


Return The query returns CHAN1, CHAN2, CHAN3, or CHAN4. 
Format 


Example :TRIGger:SHOLd:CSrc CHANnel2 /*Set the clock source to CH2*/ 
:TRIGger:SHOLd:CSrc? /*The query returns CHAN2*/ 
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:TRIGger:SHOLd:SLOPe 


Syntax 


Description 


Parameter 


Return 
Format 


Example 


:TRIGger:SHOLd:PATTern 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


:TRIGger:SHOLd:TYPe 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


RIGOL 
:TRIGger:SHOLd:SLOPe <slope> 
:TRIGger:SHOLd:SLOPe? 
Set or query the edge type in setup/hold trigger. 
Name Type Range Default 
<slope> Discrete {POSitive| NEGative} POSitive 
The query returns POS or NEG. 
:TRIGger:SHOLd:SLOPe NEGative /*Set the edge type to falling edge*/ 
:TRIGger:SHOLd:SLOPe? /*The query returns NEG*/ 
:TRIGger:SHOLd:PATTern <pattern> 
:TRIGger:SHOLd:PATTern? 
Set or query the data type in setup/hold trigger. 
Name Type Range Default 
<pattern> Discrete {H|L} H 
H: high level 
L: low level 
The query returns H or L. 
:TRIGger:SHOLd:PATTern L /*Set the data type to L*/ 
:TRIGger:SHOLd:PATTern? /*The query returns L*/ 
:TRIGger:SHOLd:TYPe <type> 
:TRIGger:SHOLd:TYPe? 
Set or query the setup type in setup/hold trigger. 
Name Type Range Default 
<type> Discrete {SETup|HOLd|SETHOLd} SETup 


>  SETup: the oscilloscope triggers when the setup time is less than the setting value 
(:TRIGger:SHOLd:STIMe). 

> HOLd: the oscilloscope triggers when the hold time is less than the setting value 
(:TRIGger:SHOLd:HTIMe). 

> SETHOLd: the oscilloscope triggers when the setup time or hold time is less than the 
corresponding setting value (: TRIGger:SHOLd:STIMe or :TRIGger:SHOLd:HTIMe),. 


The query returns SET, HOL, or SETHOL. 


/*Set the setup type to setup&hold*/ 
/*The query returns SETHOL*/ 


:TRIGger:SHOLd:TYPe SETHOLd 
:TRIGger:SHOLd:TYPe? 
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:TRIGger:SHOLd:STIMe 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


Related 
Command 


:TRIGger:SHOLd:STIMe <NR3> 
:TRIGger:SHOLd:STIMe? 
Set or query the setup time in setup/hold trigger. The default unit is s. 


Name Type Range Default 


<NR3> Real 8ns to is ius 


> Setup time refers to the period of time that the data stays stable and constant before 
the clock signal of the trigger appears. 


> This command is only available when the setup type (refer to : TRIGger: SHOLd: TYPe) 
is SETup or SETHOLd. 


The query returns the setup time in scientific notation. 


:TRIGger:SHOLd:STIMe 0.002 /*Set the setup time to 2ms*/ 
:TRIGger:SHOLd:STIMe? /*The query returns 2.000000e-03*/ 


:TRIGger:SHOLd:HTIMe 


:TRIGger:SHOLd:HTIMe 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


Related 
Command 


:TRIGger:SHOLd:HTIMe <NR3> 
:TRIGger:SHOLd:HTIMe? 
Set or query the hold time in setup/hold trigger. The default unit is s. 


Name Type Range Default 


<NR3> Real 8ns to 1s ius 


> Hold time refers to the period of time that the data stays stable and constant after 
the clock signal of the trigger appears. 


> This command is only available when the setup type (refer to : TRIGger: SHOLd: TYPe) 
is HOLd or SETHOLd. 


The query returns the hold time in scientific notation. 


:TRIGger:SHOLd:HTIMe 0.002 /*Set the hold time to 2ms*/ 
:TRIGger:SHOLd:HTIMe? /*The query returns 2.000000e-03*/ 


:TRIGger:SHOLd:STIMe 


2-198 


MSO1000Z/DS1000Z Programming Guide 


Chapter 2 Command System RIGOL 
: TRIGger:NEDGe 
Command List: 
@ :TRIGger: NEDGe:SOURce 
@ :TRIGger:NEDGe:SLOPe 
@ :TRIGger: NEDGe:IDLE 
@ :TRIGger: NEDGe:EDGE 
@ :TRIGger:NEDGe:LEVel 
:TRIGger:NEDGe:SOURCe 

Syntax :TRIGger:NEDGe:SOURce <source> 

:TRIGger: NEDGe: SOURce? 
Description Set or query the trigger source in Nth edge trigger. 
Parameter Name Type Range Default 
{D0|D1|D2|D3|D4|D5|D6|D7|D8| 
<source> | Discrete D9|D10]D11]D12|D13|D14|D15| CHANnelt1 
CHANnel1|CHANnel2|CHANnel3|CHANnel4} 
Explanation When one or more of channels DO to D7 is turned on, CH4 cannot be selected; when one 
or more of D8 to D15 is turned on, CH3 cannot be selected. 
Return The query returns DO, Di, D2, D3, D4, D5, D6, D7, D8, DI, D10, D1i1, D12, D13, D14, 
Format D15, CHANi, CHAN2, CHAN3, or CHAN4. 
Example :TRIGger:NEDGe:SOURce CHANnel2 /*Set the trigger source to CH2*/ 


:TRIGger: NEDGe:SOURce? /*The query returns CHAN2*/ 


:TRIGger:NEDGe:SLOPe 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


:TRIGger:NEDGe:SLOPe <slope> 
:TRIGger: NEDGe:SLOPe? 
Set or query the edge type in Nth edge trigger. 


Name Type Range Default 


<slope> | Discrete {POSitive| NEGative} POSitive 


> POSitive: trigger on the rising edge of the input signal when the voltage level meets 
the specified trigger level. 


> NEGative: trigger on the falling edge of the input signal when the voltage level meets 
the specified trigger level. 


The query returns POS or NEG. 


:TRIGger: NEDGe:SLOPe NEGative 
:TRIGger: NEDGe:SLOPe? 


/*Set the edge type to falling edge*/ 
/*The query returns NEG*/ 
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:TRIGger:NEDGe:IDLE 


Syntax 


Description 


Parameter 


Return Format 


Example 


:TRIGger:NEDGe: IDLE <NR3> 
:TRIGger:NEDGe: IDLE? 
Set or query the idle time in Nth edge trigger. The default unit is s. 


Name _ | Type Range Default 


<NR3> _ | Real 16ns to 10s 


1s 


The query returns the idle time in scientific notation. 


:TRIGger:NEDGe:IDLE 0.002 /*Set the idle time to 2ms*/ 
:TRIGger:NEDGe: IDLE? /*The query returns 2.000000e-03*/ 


:TRIGger:NEDGe: EDGE 


Syntax 


Description 


Parameter 


Return Format 


Example 


:TRIGger:NEDGe:EDGE <NR1> 

:TRIGger: NEDGe: EDGE? 

Set or query the number of edges in Nth edge trigger. 
Type 
Integer 


Name 
<NR1> 


Range Default 
1 to 65535 2 
The query returns an integer between 1 and 65535. 


:TRIGger:NEDGe:EDGE 20 /*Set the number of edges to 20*/ 
:TRIGger: NEDGe: EDGE? /*The query returns 20*/ 


:TRIGger:NEDGe:LEVel 


Syntax 


Description 


Parameter 


Explanation 


Return Format 


Example 


:TRIGger:NEDGe:LEVel <level> 
:TRIGger:NEDGe:LEVel? 


Set or query the trigger level in Nth edge trigger. The unit is the same as the current 
amplitude unit. 


Name _ | Type Range Default 
(-5 x VerticalScale - OFFSet) to 
alevel>: | Beal (5 x VerticalScale - OFFSet) ° 


> For VerticalScale, refer to :CHANnel<n>:SCALe. For OFFSet, refer 
to :CHANnel<n>:OFFSet. 


> This command is only available when the signal source is an analog channel. 
The query returns the trigger level in scientific notation. 


:TRIGger:NEDGe:LEVel 0.16 /*Set the trigger level to 160mV*/ 
:TRIGger: NEDGe:LEVel? /*The query returns 1.600000e-01*/ 
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: TRIGger:RS232 


Command List: 
:TRIGger:RS232:SOURce 
:TRIGger:RS232: WHEN 
:TRIGger:RS232:PARity 
:TRIGger:RS232:STOP 
:TRIGger:RS232:DATA 
:TRIGger:RS232:WIDTh 
:TRIGger:RS232:BAUD 
:TRIGger:RS232:BUSer 
:TRIGger:RS232:LEVel 


, i A 2 A 2 A 


:TRIGger:RS232:SOURCe 
Syntax :TRIGger:RS232:SOURce <source> 
:TRIGger:RS232:SOURce? 
Description Set or query the trigger source in RS232 trigger. 


Parameter Name Type Range Default 
{D0|D1|D2|D3]D4|D5|D6|D7|D8| 
<source> | Discrete | D9|D10|D11|D12|D13|D14|D15]| CHANneli 
CHANnel1|CHANnel2|CHANnel3|CHANnel4} 


Explanation When one or more of channels DO to D7 is turned on, CH4 cannot be selected; when one 
or more of D8 to D15 is turned on, CH3 cannot be selected. 


Return The query returns DO, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, Di1, D12, D13, D14, 
Format D15, CHAN1, CHAN2, CHAN3, or CHAN4. 


Example  :TRIGger:RS232:SOURce CHANnel2 /*Set the trigger source to CH2*/ 
:TRIGger:RS232:SOURce? /*The query returns CHAN2*/ 
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:TRIGger:RS232:WHEN 
Syntax :TRIGger:RS232:WHEN <when> 
:TRIGger:RS232: WHEN? 
Description Set or query the trigger condition in RS232 trigger. 


Parameter Name Type Range Default 
<when> Discrete | {STARt|ERRor|PARity| DATA} STARt 
Explanation >  STARt: trigger on the start frame position. 
> ERRor: trigger when error frame is detected. 
>  PARity: trigger when check error is detected. 
> DATA: trigger on the last bit of the preset data bits and even-odd check bits. 


Return Format The query returns STAR, ERR, PAR, or DATA. 


Example :TRIGger:RS232:WHEN ERRor /*Set the trigger condition to error frame*/ 
:TRIGger:RS232: WHEN? /*The query returns ERR*/ 


Related :TRIGger:RS232:DATA 
Command 


:TRIGger:RS232:PARity 
Syntax :TRIGger:RS232:PARity <parity> 
:TRIGger:RS232:PARity? 


Description Set or query the parity type when the trigger condition is ERRor or PARity in RS232 
trigger. 


Parameter Name Type Range Default 
Error Frame: NONE 
Check Error: ODD 


Explanation When the trigger condition is PARity, the parity type cannot be set to NONE. At this 
point, the default parity type is ODD. 


Return Format The query returns EVEN, ODD, or NONE. 


Example :TRIGger:RS232:PARity EVEN /*Set the parity type to even*/ 
:TRIGger:RS232:PARity? /*The query returns EVEN*/ 


Related :TRIGger:RS232:WHEN 
Command 


<parity> Discrete {EVEN|ODD|NONE} 
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:TRIGger:RS232:STOP 
Syntax :TRIGger:RS232:STOP <bit> 
:TRIGger:RS232:STOP? 
Description Set or query the stop bit when the trigger condition is ERRor in RS232 trigger. 


Parameter Name Type Range Default 
<bit> Discrete {1]2} 1 


Return Format The query returns 1 or 2. 


Example :TRIGger:RS232:STOP 2 /*Set the stop bit to 2*/ 
:TRIGger:RS232:STOP? /*The query returns 2*/ 


Related :TRIGger:RS232:WHEN 
Command 


:TRIGger:RS232:DATA 
Syntax :TRIGger:RS232:DATA <data> 
:TRIGger:RS232:DATA? 
Description Set or query the data when the trigger condition is DATA in RS232 trigger. 


Parameter Name Type Range Default 
<data> Integer 0 to 2"-1 90 


Explanation In the expression 2"-1, n is the current data bits and can be 5, 6, 7, or 8. 
Return Format The query returns an integer. 


Example :TRIGger:RS232:DATA 10 /*Set the data to 10*/ 
:TRIGger:RS232:DATA? /*The query returns 10*/ 


Related :TRIGger:RS232:WIDTh 
Commands  teiGger:RS232: WHEN 


:TRIGger:RS232:WIDTh 
Syntax :TRIGger:RS232:WIDTh <width> 
:TRIGger:RS232:WIDTh? 
Description Set or query the data bits when the trigger condition is DATA in RS232 trigger. 


Parameter Name Type Range Default 
<width> Discrete {5|6|7|8} 8 


Return Format The query returns 5, 6, 7, or 8. 


Example :TRIGger:RS232:WIDTh 6 /*Set the data bits to 6*/ 
:TRIGger:RS232:WIDTh? /*The query returns 6*/ 


Related :TRIGger:RS232:WHEN 
Command 
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:TRIGger:RS232:BAUD 
Syntax :TRIGger:RS232:BAUD <baud_rate> 


Description 


Parameter 


Return Format 


Example 


Related 
Command 


:TRIGger:RS232:BAUD? 


Chapter 2 Command System 


Set or query the baud rate in RS232 trigger. The default unit is bps. 


Name Type Range Default 
{2400|4800|9600|19200|38400|57600| 

<baud_rate> | Discrete | 115200|230400|460800|921600|1000000| | 9600 
USER} 


The query returns an integer or USER. 


/*Set the baud rate to 4800bps*/ 
/*The query returns 4800*/ 


:TRIGger:RS232:BAUD 4800 


:TRIGger:RS232:BAUD? 
:TRIGger:RS232:BUSer 


:TRIGger:RS232:BUSer 
Syntax :TRIGger:RS232:BUSer <user baud> 


Description 


Parameter 


Return Format 


Example 


Related 
Command 


:TRIGger:RS232:BUSer? 


Set or query the user-defined baud rate in RS232 trigger. The default unit is bps. 


Name Type 


Range 


Default 


<user baud> | Integer 


110 to 20000000 


9600 


The query returns an integer. 


:TRIGger:RS232:BUSer 50000 


:TRIGger:RS232:BUSer? 
:TRIGger:RS232:BAUD 


/*Set the user-defined baud rate to 50000bps*/ 


/*The query returns 50000*/ 
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:TRIGger:RS232:LEVel 


Syntax :TRIGger:RS232:LEVel <level> 
:TRIGger:RS232:LEVel? 


Description Set or query the trigger level in RS232 trigger. The unit is the same as the current 


amplitude unit. 


RIGOL 


Parameter Name Type 


Range 


Default 


<level> | Real 


(-5 x VerticalScale - OFFSet) to 
(5 x VerticalScale - OFFSet) 


0 


Explanation > _ For VerticalScale, refer to :CHANnel<n>:SCALe. For OFFSet, refer 


to :CHANnel<n>:OFFSet. 


> This command is only available when the signal source is an analog channel. 


Return Format The query returns the trigger level in scientific notation. 


Example :TRIGger:RS232:LEVel 0.16 
:TRIGger:RS232:LEVel? 


/*Set the trigger level to 160mV*/ 
/*The query returns 1.600000e-01*/ 
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:TRIGger:IIC 


Command List: 


@ :TRIGger:TIC:SCL 
@ :TRIGger:IIC:SDA 
@ :TRiGger:IIC: WHEN 
@ :TRiGger:IIC:AWIDth 
@ = :TRIGger:IIC:ADDRess 
@ :TRiGger:IIC:DiRection 
@ :TRiGger:IIC:DATA 
@ :TRIGger:IIC:CLEVel 
@ :TRIGger:IIC:DLEVel 
:TRIGger:IIC:SCL 
Syntax :TRIGger:IIC:SCL <source> 
:TRIGger:IIC:SCL? 
Description Set or query the channel source of SCL in I2C trigger. 
Parameter Name Type Range Default 
{D0|D1|D2|D3]D4|D5|D6|D7|D8| 
<source> | Discrete D9|D10|D11|D1i2|D13]D1i4|D15]| CHANnel1 
CHANnel1|CHANnel2|CHANnel3|CHANnel4} 
Explanation When one or more of channels DO to D7 is turned on, CH4 cannot be selected; when one 
or more of D8 to D15 is turned on, CH3 cannot be selected. 
Return The query returns DO, Di, D2, D3, D4, D5, D6, D7, D8, D9, D10, Di1, D12, D13, D14, 
Format D1i5, CHAN1, CHAN2, CHAN3, or CHAN4. 
Example :TRIGger:IIC:SCL CHANnel2 /*Set the SCL source to CH2*/ 
:TRIGger:IIC:SCL? /*The query returns CHAN2*/ 
:TRIGger:IIC:SDA 
Syntax :TRIGger:IIC:SDA <source> 
:TRIGger:IIC:SDA? 
Description Set or query the channel source of SDA in I2C trigger. 
Parameter Name Type Range Default 
{D0|D1i|D2|D3|D4|D5|D6|D7|D8| 
<source> | Discrete D9|D10|D11|D1i2|D13]D14|D15| CHANnel2 
CHANnel1| CHANnel2|CHANnel3|CHANnel4} 
Explanation When one or more of channels DO to D7 is turned on, CH4 cannot be selected; when one 
or more of D8 to D15 is turned on, CH3 cannot be selected. 
Return The query returns DO, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D1i1, D12, D13, D14, 
Format D15, CHAN1, CHAN2, CHAN3, or CHAN4. 
Example :TRIGger:IIC:SDA CHANnel2 /*Set the SDA source to CH2*/ 
:TRIGger:IIC:SDA? /*The query returns CHAN2*/ 
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:TRIGger:IIC:WHEN 
Syntax :TRIGger:IIC:WHEN <trig_type> 
:TRIGger:IIC: WHEN? 
Description Set or query the trigger condition in I2C trigger. 


Parameter Name Type Range Default 


{STARt|RESTart|STOP|NACKnowledge| 
ADDRess|DATA|ADATa} 


<trig_type> | Discrete STARt 


Explanation >  STARt: trigger when the SDA data transitions from high to low while the SCL is 
high. 


> RESTart: trigger when another start condition occurs before a stop condition. 


> STOP: trigger when the SDA data transitions from low to high while the SCL is 
high. 


> NACKnowledge: trigger when the SDA data is high during any acknowledgement 
of the SCL clock position. 


> ADDRess: search for the specified address value and trigger on the read/write 
bit. 


> DATA: search for the specified data value on the data line (SDA) and trigger on 
the jump edge of the clock line (SCL) corresponding to the last bit of the data. 


> ADATai:search for the specified address value and data value at the same time 
and trigger when the "Address" and "Data" conditions are met at the same time. 


Return Format The query returns STAR, STOP, NACK, REST, ADDR, DATA, or ADAT. 


Example = :TRIGger:IIC:WHEN RESTart /*Set the trigger condition to restart*/ 
:TRIGger:IIC: WHEN? /*The query returns REST*/ 


:TRIGger:IIC:AWIDth 
Syntax :TRIGger:IIC:AWIDth <bits> 
:TRIGger:IIC:AWIDth? 
Description Set or query the address bits when the trigger condition is ADDRess or ADATa in 


I2C trigger. 
Parameter Name Type Range Default 
<bits> Discrete | {7|8|10} 7 


Return Format The query returns 7, 8, or 10. 


Example :TRIGger:IIC:AWIDth 10 /*Set the address bits to 10*/ 
:TRIGger:IIC:AWIDth? /*The query returns 10*/ 


Related :TRiGger:IIC:DIRection 


Commands teiGger:IIC:ADDRess 


MSO1000Z/DS1000Z Programming Guide 2-207 


RIGOL Chapter 2 Command System 


:TRIGger:IIC:ADDRess 
Syntax :TRIGger:IIC:ADDRess <adr> 
:TRIGger:IIC:ADDRess? 
Description Set or query the address when the trigger condition is ADDRess or ADATa in I2C 


trigger. 
Parameter Name Type Range Default 
<adr> Integer | 0 to 2"-1: 0 to 127, 0 to 255, or 0 to 1023 1 


Explanation In the expression 2"-1, n is the current address bits. 
Return Format The query returns an integer. 


Example :TRIGger:IIC:ADDRess 100 /*Set the address to 100*/ 
:TRIGger:IIC:ADDRess? /*The query returns 100*/ 


Related :TRIGger:IIC:AWIDth 
Command 


:TRIGger:IIC:DIRection 
Syntax :TRIGger:IIC:DIRection <dir> 
:TRIGger:IIC:DIRection? 
Description Set or query the data direction when the trigger condition is ADDRess or ADATa in I2C 


trigger. 
Parameter Name Type Range Default 
<dir> Discrete | {READ|WRITe|RWRite} READ 


Explanation This command is invalid when the address bits is 8. 
Return Format The query returns READ, WRIT, or RWR. 
Example :TRIGger:IIC:DIRection RWRite /*Set the data direction to read/write*/ 


:TRIGger:IIC:DIRection? /*The query returns RWR*/ 
Related :TRIGger:IIC:AWIDth 
Command 
:TRIGger:IIC:DATA 


Syntax :TRIGger:IIC:DATA <data> 
:TRIGger: TIC: DATA? 
Description Set or query the data when the trigger condition is DATA or ADATa in I2C trigger. 


Parameter Name Type Range Default 
<data> | Integer | Oto 2*°-1 82 


Explanation The range of <data> is related to the byte length. The maximum byte length is 5, 
namely 40 bit binary data. Thus, the range of <data> is from 0 to 2-1. 


Return Format The query returns an integer. 


Example :TRIGger:IIC:DATA 64 /*Set the data to 64*/ 
:TRIGger:IIC: DATA? /*The query returns 64*/ 


Related :TRIGger:IIC: WHEN 
Command 


2-208 MSO1000Z/DS1000Z Programming Guide 


Chapter 2 Command System RIGOL 


:TRIGger:IIC:CLEVel 
Syntax :TRIGger:IIC:CLEVel <level> 
:TRIGger:IIC:CLEVel? 


Description Set or query the trigger level of SCL in I2C trigger. The unit is the same as the 
current amplitude unit. 


Parameter Name _| Type | Range Default 
(-5 x VerticalScale - OFFSet) to 
aleve | Beal (5 x VerticalScale - OFFSet) ‘ 


Explanation > _ For VerticalScale, refer to :CHANnel<n>:SCALe. For OFFSet, refer 
to :CHANnel<n>:OFFSet. 


> This command is only available when the signal source of the clock line is an 
analog channel. 


Return Format The query returns the trigger level of SCL in scientific notation. 


Example :TRIGger:IIC:CLEVel 0.16 /*Set the trigger level of SCL to 160mV*/ 
:TRIGger:IIC:CLEVel? /*The query returns 1.600000e-01*/ 


:TRIGger:IIC:DLEVel 
Syntax :TRIGger:IIC:DLEVel <level> 
:TRIGger:IIC:DLEVel? 


Description Set or query the trigger level of SDA in I2C trigger. The unit is the same as the 
current amplitude unit. 


Parameter Name | Type | Range Default 
(-5 x VerticalScale - OFFSet) to 
level | Real (5 x VerticalScale - OFFSet) 0 


Explanation > _ For VerticalScale, refer to :CHANnel<n>:SCALe. For OFFSet, refer 
to :CHANnel<n>:OFFSet. 


> This command is only available when the signal source of the data line is an 
analog channel. 


Return Format The query returns the trigger level of SDA in scientific notation. 


Example :TRIGger:IIC:DLEVel 0.16 /*Set the trigger level of SDA to 160mV*/ 
:TRIGger:IIC:DLEVel? /*The query returns 1.600000e-01*/ 
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:-TRIGger:SPI 


Command List: 
:TRIGger:SPI:SCL 
:TRIGger:SPI:SDA 
:TRIGger:SPI: WHEN 
:TRIGger:SPI:WIDTh 
:TRIGger:SPI:DATA 
:TRIGger:SPI: TiMeout 
:TRIGger:SPI:SLOPe 
:TRIGger:SPI:CLEVel 
:TRIGger:SPI:DLEVel 
:TRIGger:SPI:SLEVel 
:TRIGger:SPI: MODE 
:TRIGger:SPI:CS 


, i 2 A 2 A A A A A A 


:TRIGger:SPI:SCL 
Syntax :TRIGger:SPI:SCL <source> 
:TRIGger:SPI:SCL? 


Description Set or query the channel source of SCL in SPI trigger. 


Parameter Name Type Range Default 
{D0|D1|D2|D3|D4|D5|D6|D7|D8| 
<source> | Discrete D9|D10|D11]D12|D13|D14|D15| CHANnel1i 
CHANnel1 | CHANnel2|CHANnel3|CHANnel4} 


Explanation When one or more of channels DO to D7 is turned on, CH4 cannot be selected; when one 
or more of D8 to D15 is turned on, CH3 cannot be selected. 


Return The query returns DO, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, Di1, D12, D13, D14, 
Format D15, CHANi, CHAN2, CHAN3, or CHAN4. 


Example :TRIGger:SPI:SCL CHANnel1 /*Set the channel source of SCL to CH1*/ 
:TRIGger:SPI:SCL? /*The query returns CHAN1*/ 
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:TRIGger:SPI:SDA 
Syntax :TRIGger:SPI:SDA <source> 
:TRIGger:SPI:SDA? 
Description Set or query the channel source of SDA in SPI trigger. 
Parameter Name Type Range Default 
{D0|D1|D2|D3|D4|D5|D6|D7|D8| 
<source> Discrete D9|D10|D11]D12|D13|D14|D15]| CHANnel2 
CHANnel1|CHANnel2|CHANnel3|CHANnel4} 
Explanation When one or more of channels DO to D7 is turned on, CH4 cannot be selected; when one 
or more of D8 to D15 is turned on, CH3 cannot be selected. 
Return The query returns DO, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, Di1, D12, D13, D14, 
Format D15, CHAN1, CHAN2, CHAN3, or CHAN4. 
Example :TRIGger:SPI:SDA CHANnel2 /*Set the channel source of SDA to CH2*/ 
:TRIGger:SPI:SDA? /*The query returns CHAN2*/ 
:TRIGger:SPI: WHEN 
Syntax :TRIGger:SPI:WHEN <trig_type> 
:TRIGger:SPI: WHEN? 
Description Set or query the trigger condition in SPI trigger. 
Parameter Name Type Range Default 
<trig_type> Discrete {CS|TIMeout} cS 
Explanation When the trigger condition is set to TIMeout, you can use the :TRIGger:SPI:TIMeout 
command to set the timeout value. 
Return The query returns CS or TIM. 
Format 
Example :TRIGger:SPI: WHEN TIMeout /*Set the trigger condition to TIMeout*/ 


:TRIGger:SPI: WHEN? /*The query returns TIM*/ 


:TRIGger:SPI:WIDTh 


Syntax :TRIGger:SPI:WIDTh <width> 
:TRIGger:SPI:WIDTh? 
Description Set or query the data bits of the SDA channel in SPI trigger. 
Parameter Name Type Range Default 
<width> Integer 4 to 32 8 
Return § The query returns an integer. 
Format 
Example :TRIGger:SPI:WIDTh 10 /*Set the data bits of the SDA channel to 10*/ 
:TRIGger:SPI:WIDTh? /*The query returns 10*/ 
Related :TRIGger:SPI:DATA 
Command 
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:TRIGger:SPI:DATA 
Syntax :TRIGger:SPI:DATA <data> 
:TRIGger:SPI:DATA? 
Description Set or query the data in SPI trigger. 
Parameter Name Type Range Default 
<data> Integer | 0 to 2°%-1 82 
Explanation The range of <data> is related to the data bits. The maximum data bits is 32. Thus, the 
range of <data> is from 0 to 2°~-1. 
Return The query returns an integer. 
Format 
Example :TRIGger:SPI:DATA5 /*Set the data to 5*/ 
:TRIGger:SPI:DATA? /*The query returns 5*/ 
Related :TRIGger:SPI:WIDTh 
Command 


:TRIGger:SPI:TIMeout 


Syntax 


Description 


Parameter 


Return 
Format 


Example 


Related 
Command 


:TRIGger:SPI:TIMeout <time_value> 
:TRIGger:SPI: TIMeout? 


Set or query the timeout value when the trigger condition is TIMeout in SPI trigger. The 
default unit is s. 


:TRIGger:SPI:SLOPe 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


Name Type Range Default 
<time_value> Real 100ns to is ius 

The query returns the timeout value in scientific notation. 

:TRIGger:SPI:TIMeout 0.001 /*Set the timeout value to ims*/ 

:TRIGger:SPI: TIMeout? /*The query returns 1.000000e-03*/ 

:TRIGger:SPI: WHEN 

:TRIGger:SPI:SLOPe <slope> 

:TRIGger:SPI:SLOPe? 

Set or query the clock edge in SPI trigger. 
Name Type Range Default 
<slope> Discrete | {POSitive| NEGative} POSitive 


POSitive: sample the SDA data on the rising edge of the clock. 
NEGative: sample the SDA data on the falling edge of the clock. 


The query returns POS or NEG. 


:TRIGger:SPI:SLOPe POSitive 
:TRIGger:SPI:SLOPe? 


/*Set the clock edge to POSitive*/ 
/*The query returns POS*/ 
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:TRIGger:SPI:CLEVel 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


:TRIGger:SPI:CLEVel <level> 
:TRIGger:SPI:CLEVel? 


Set or query the trigger level of the SCL channel in SPI trigger. The unit is the same as the 
current amplitude unit. 


Name Type | Range Default 
Aieviels.'| Real (-5 x VerticalScale - OFFSet) to 0 
(5 x VerticalScale - OFFSet) 


> For VerticalScale, refer to :CHANnel<n>:SCALe. For OFFSet, refer 
to :CHANnel<n>:OFFSet. 


> This command is only available when the signal source of the clock line is an analog 
channel. 


The query returns the trigger level of the SCL channel in scientific notation. 


:TRIGger:SPI:CLEVel 0.16 
:TRIGger:SPI:CLEVel? 


/*Set the trigger level of the SCL channel to 160mV*/ 
/*The query returns 1.600000e-01*/ 


:TRIGger:SPI:DLEVel 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


:TRIGger:SPI:DLEVel <level> 
:TRIGger:SPI:DLEVel? 


Set or query the trigger level of the SDA channel in SPI trigger. The unit is the same as the 
current amplitude unit. 


Name Type | Range Default 
Aevels. | Real (-5 x VerticalScale - OFFSet) to 0 
(5 x VerticalScale - OFFSet) 


> For VerticalScale, refer to :CHANnel<n>:SCALe. For OFFSet, refer 
to :CHANnel<n>:OFFSet. 


> This command is only available when the signal source of the data line is an analog 
channel. 


The query returns the trigger level of the SDA channel in scientific notation. 


:TRIGger:SPI:DLEVel 0.16 /*Set the trigger level of the SDA channel to 160mV*/ 
:TRIGger:SPI:DLEVel? /*The query returns 1.600000e-01*/ 
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:TRIGger:SPI:SLEVel 
Syntax :TRIGger:SPI:SLEVel <level> 
:TRIGger:SPI:SLEVel? 


Description Set or query the trigger level of the CS channel in SPI trigger. The unit is the same as the 
current amplitude unit. 


Parameter Name Type Range Default 


(-5 x VerticalScale - OFFSet) to 
(5 x VerticalScale - OFFSet) 


Explanation > _ For VerticalScale, refer to :CHANnel<n>:SCALe. For OFFSet, refer 
to :CHANnel<n>:OFFSet. 


<level> Real 0 


> This command is only available when the signal source of the CS line is an analog 
channel. 


Return The query returns the trigger level of the CS channel in scientific notation. 
Format 


Example :TRIGger:SPI:SLEVel 0.16 /*Set the trigger level of the CS channel to 160mV*/ 
:TRIGger:SPI:SLEVel? /*The query returns 1.600000e-01*/ 


:TRIGger:SPI:MODE 
Syntax :TRIGger:SPI:MODE <mode> 
:TRIGger:SPI:MODE? 
Description Set or query the CS mode when the trigger condition is CS in SPI trigger. 


Parameter Name Type Range Default 
<mode> | Discrete | {HIGH|LOW} LOW 
Return The query returns HIGH or LOW. 
Format 
Example :TRIGger:SPI:MODE LOW  #/*Set the CS mode to low*/ 
:TRIGger:SPI: MODE? /*The query returns LOW*/ 
Related :TRIGger:SPI: WHEN 
Command 
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:TRIGger:SPI:CS 
Syntax :TRIiGger:SPI:CS <source> 
:TRIGger:SPI:CS? 
Description Set or query the data source of the CS signal in SPI trigger. 
Parameter Name Type Range Default 
{D0|D1|D2|D3|D4|D5|D6|D7|D8| 
<source> | Discrete | D9|D10]D11]D12|D13|D14|D15| CHANnel3 

CHANnel1|CHANnel2|CHANnel3|CHANnel4} 


Explanation 


Return 
Format 


Example 


When one or more of channels DO to D7 is turned on, CH4 cannot be selected; when one 
or more of D8 to D15 is turned on, CH3 cannot be selected. 


The query returns DO, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, 
D15, CHAN1, CHAN2, CHAN3, or CHAN4. 


:TRIGger:SPI:CS CHANnel2 


:TRIGger:SPI:CS? 


/*The query returns CHAN2*/ 


/*Set the data source of the CS signal to CH2*/ 
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:-WAVeform Commands 


The :WAVeform commands are used to read the waveform data and its related settings. : WAVeform:MODE 
is used to set the reading mode of the waveform data. In different mode, the definition of each parameter 
is different, as shown in Figure 2-1 and Figure 2-2. 


RIGOL 916° 'H sous wEaMeas | ¥ D -180.000000us TSO 0.00 
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aaureh 2- 1 Parametek Definitions in NORMAL Mode 


Figure 2-2 Paramter Definitions in RAW Mode 


Note!4/: In RAW mode, YINCrement is related to the Verticalscale of the internal waveform and the Verticalscale 


currently selected. 
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Command List: 
:WAVeform:SOURce 
:WAVeform:MODE 
:WAVeform:FORMat 
:WAVeform:DATA? 


:WAVeform:XORigin? 
:WAVeform:XREFerence? 


:WAVeform:YORigin? 
:WAVeform:YREFerence? 
:WAVeform:STARt 
:WAVeform:STOP 
:WAVeform:PREamble? 


5 A A A A A A A A A A 


:WAVeform:XINCrement? 


:WAVeform:YINCrement? 


:-WAVeform:SOURce 
Syntax :WAVeform:SOURce <source> 
:WAVeform:SOURce? 


Description Set or query the channel of which the waveform data will be read. 


RIGOL 


Parameter Name 


Type 


Range 


Default 


<source> 


Discrete 


{D0|D1|D2|D3|D4|D5|D6|D7|D8| 
D9|D10]D11]D12|D13|D14]D15]| 
CHANnel1|CHANnel2|CHANnel3|CHANnel4|MATH} 


CHANnel1 


Explanation > __ If the MATH channel is selected, only NORMal can be selected in : WAVeform:MODE. 


> — If andigital channel (DO to D15) is selected, the :WAVeform:DATA? command always 
returns the waveform data in BYTE format. If the waveform data on the screen is 
read, the signal status of the channel source currently selected is returned and a 
waveform point occupies one byte (8 bits). If the waveform data in the internal 
memory is read, the signal statuses of the channel group (D7 to DO or D15 to D8; 8 
digital channels) which includes the channel source currently selected are returned; 
one byte represents the statuses of a group of digital signals and the data represents 
the statuses of D7 to DO (or D15 to D8) respectively from the highest bit to the 
lowest bit. 


Return The query returns DO, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D1i1, D12, D13, D14, 
Format D15, CHANi, CHAN2, CHAN3, CHAN4, or MATH. 


Example :WAVeform:SOURce CHANnel2 /*Set the channel to CH2*/ 
:WAVeform:SOURce? 


Related :WAVeform:FORMat 


Command 


/*The query returns CHAN2*/ 
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:WAVeform:MODE 
Syntax :WAVeform:MODE <mode> 
:WAVeform:MODE? 
Description Set or query the reading mode used by :WAVeform:DATA?. 
Parameter Name Type Range Default 
<mode> Discrete | {NORMal]MAXimum|RAW} NORMal 
Explanation > NORMal: read the waveform data displayed on the screen. 
> MAXimum: read the waveform data displayed on the screen when the instrument is 
in the run state and the waveform data in the internal memory in the stop state. 
> RAW: read the waveform data in the internal memory. Note that the waveform data 
in the internal memory can only be read when the oscilloscope is in the stop state 
and the oscilloscope cannot be operated during the reading process. 
> — If the MATH channel is selected, only the NORMal mode is valid. 
Return The query returns NORM, MAX, or RAW. 
Format 
Example :WAVeform:MODE RAW /*Set the reading mode to RAW*/ 
:WAVeform:MODE? /*The query returns RAW*/ 
:WAVeform:FORMat 
Syntax :WAVeform:FORMat <format> 
:WAVeform:FORMat? 
Description Set or query the return format of the waveform data. 
Parameter Name Type Range Default 
<format> | Discrete | {WORD|BYTE|ASCii} BYTE 
Explanation > WORD: a waveform point occupies two bytes (namely 16 bits) in which the lower 8 
bits are valid and the higher 8 bits are 0. 
> BYTE: a waveform point occupies one byte (namely 8 bits). 
ASCii: return the actual voltage value of each waveform point in scientific notation. 
The voltage values are separated by commas. 
Return The query returns WORD, BYTE, or ASC. 
Format 
Example :WAVeform:FORMat WORD  /*Set the return format to WORD*/ 
:WAVeform:FORMat? /*The query returns WORD*/ 
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:WAVeform:DATA? 
Syntax :WAVeform:DATA? 
Description Read the waveform data. 
Explanation > Reading procedures of the screen waveform data: 
S1. :WAV:SOUR CHAN1 Set the channel source to CH1 
S2. :WAV:MODE NORM Set the waveform reading mode to NORMal 


S3. :WAV:FORM BYTE Set the return format of the waveform data 
to BYTE 
S4. :WAV:DATA? Read the screen waveform data 


> Reading procedures of the internal memory waveform data: 


Tip: 
When reading the waveform data in the internal memory, the maximum number 
of waveform points can be read each time the :WAV:DATA? command is sent is 
related to the return format of the waveform data currently selected, as shown 
in the table below. 


Return Format of Maximum Number of Waveform Points can 
the Waveform Data | pe Read Each Time 

BYTE 250000 

WORD 125000 

ASCii 15625 


Before reading the waveform data in the internal memory, you need to judge 
whether the waveform data can all be read at one time according to the memory 
depth of the oscilloscope and the maximum number of waveform points that can 
be read each time (refer to the table above). 

1) When the memory depth of the oscilloscope is lower than or equal to the 
maximum number of waveform points that can be read each time, the 
waveform data in the internal memory can all be read at one time by 
specifying the start point and stop point. 

2) When the memory depth of the oscilloscope is greater than the maximum 
number of waveform points that can be read each time, the waveform data 
in the internal memory need to be read in several batches by specifying the 
start point and stop point. Each time, only the waveform data in one area of 
the internal memory is read (the waveform data of two neighbouring areas 
are continuous); then, you need to combine the waveform data that are 
read separately in sequence. 


Example 1 (read the internal memory waveform data at one time): 
Assume that the memory depth of the oscilloscope is 120kpts and the return 
format of the waveform data is BYTE; at this point, the memory depth of the 
oscilloscope is lower than the maximum number of waveform points that can be 
read each time (250000) and you can read all the waveform data in the internal 
memory at one time. 


The reading procedures are as follows. 

Si. :STOP Set the instrument to STOP state (you can only read 
the waveform data in the internal memory when the 
oscilloscope is in STOP state) 

S2. :WAV:SOUR CHAN1 Set the channel source to CH1 


S3. :WAV:MODE RAW Set the waveform reading mode to RAW 
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S4. :WAV:FORM BYTE Set the return format of the waveform data to BYTE 
S5. :WAV:STAR 1 Set the start point of waveform data reading to the 

first waveform point 

S6. :WAV:STOP 120000 Set the stop point of waveform data reading to the 

120000th waveform point (the last point) 

S7. :WAV:DATA? Read the waveform data in the internal memory (all 

the points) 
Example 2 (read the internal memory waveform data in several 
batches): 
Assume that the memory depth of the oscilloscope is 300kpts and the return 
format of the waveform data is WORD; at this point, the memory depth of the 
oscilloscope is greater than the maximum number of waveform points that can be 
read each time (125000) and you need to read all the waveform data in the 
internal memory in at least 3 batches (300000/125000=2.4). 
When reading the waveform data in batches, note that the number of waveform 
points in the internal memory that is read each time (namely, stop point - start 
point + 1) cannot be greater than the maximum number of points that can be 
read each time (in this example, it is 125000); then, you need to combine the 
waveform data that are read separately in sequence. The figure below shows an 
example of the start point and stop point settings when reading the above 
waveform data in the internal memory in 3 batches. 

The first batch The second batch The third batch 
(125000 waveform points (125000 waveform points (50000 waveform points 
in total) in total) in total) 

The corresponding reading procedures are as follows. 

S1. :STOP Set the instrument to STOP state (you can only read 
the waveform data in the internal memory when the 
oscilloscope is in STOP state) 

S2. :WAV:SOUR CHAN1i _ Set the channel source to CH1 

S3. :WAV:MODE RAW Set the waveform reading mode to RAW 

S4. :WAV:FORM WORD _ Set the return format of the waveform data to WORD 

Perform the first reading operation 

S5. :WAV:STAR 1 Set the start point of the first reading operation to the 
first waveform point 

S6. :WAV:STOP 125000 ‘Set the stop point of the first reading operation to the 
125000th waveform point 

S7. :WAV:DATA? Read the data from the first waveform point to the 
125000th waveform point 

Perform the second reading operation 

S8. :WAV:STAR 125001 Set the start point of the second reading operation to 
the 125001th waveform point 

S9. :WAV:STOP 250000 __ Set the stop point of the second reading operation to 
the 250000th waveform point 

S10. :WAV:DATA? Read the data from the 125001th waveform point to 
the 250000th waveform point 

Perform the third reading operation 

S11. :WAV:STAR 250001 Set the start point of the third reading operation to 
the 250001th waveform point 

S12. :WAV:STOP 300000 Set the stop point of the third reading operation to 
the 300000th waveform point (the last point) 

2-220 MSO1000Z/DS1000Z Programming Guide 


Chapter 2 Command System RIGOL 


S13. :WAV:DATA? Read the data from the 250001th waveform point to 
the 300000th waveform point (the last point) 
Finally, combine the data read in the 3 reading operations in sequence. 


Return > The return format is related to the return format of the waveform data currently 

Format selected (: WAVeform:FORMat). 
WORD or BYTE format: the data returned consists of 2 parts, including the TMC 
data description header and the waveform data. The format of the TMC data 
description header is #NXXXXXXXXX; wherein, # is the denoter, N is 9 and the 9 
data following it denote the number of bytes of the waveform data. The TMC data 
description header is followed by the waveform data. 
ASCii format: the query returns the actual voltage value of each waveform point in 
scientific notation; the voltage values are separated by ",”. 
Note: If the channel source of waveform data reading (: WAVeform:SOURCe) is 
set to an digital channel (DO to D15), the query always returns the waveform data 
in BYTE format. If the waveform data on the screen is read, the signal status of 
the channel source currently selected is returned and a waveform point occupies 
one byte (8 bits). If the waveform data in the internal memory is read, the signal 
statuses of the channel group (D7 to DO or D15 to D8; 8 digital channels) which 
includes the channel source currently selected are returned; one byte represents 
the statuses of a group of digital signals and the data represents the statuses of 
D7 to DO (or D15 to D8) respectively from the highest bit to the lowest bit. 


> When reading the waveform data in the internal memory in several batches, the 
data returned each time is the data in one area in the internal memory. Each of 
the data returned contains the TMC data description header (WORD or BYTE 
format) and the waveform data from two adjacent areas are continuous. 


> The figure below shows the waveform data read (in BYTE format). First, select 
"View as hexadecimal only" in the dropdown list at the right side. At this point, the 
waveform data read is displayed in hexadecimal form with the first 11 bytes being 
the TMC data description header and the others starting from the 12" byte 
(namely 8E) being the waveform data. Users can convert the waveform data read 
to the voltage value of each waveform point using (Ox8E - YORigin - 
YREFerence) x YINCrement. 


Select or Enter Command Bytes to Read 
|: WAV:DATA? In v 1024) 


TMC Data Description Header Data Display Type 
Waveform Data 


es —— 


v 


——_———————— 
|View as hexadecimal only 


1: Write Operation SSWAY:DATA?\n) 4| 


Return Count: 11 bytes 


2: Read Operation 
Return wount: 1024 bytes 


23 39 30 30 30 30 30 31 32 30 30)SE SF SF 8F 8F 90 oF 31 
90 91 91 90 91 92 91 93 91 93 92 92 94 92 93 92 93 94 93 


Clear Buffer 


Related :WAVeform:MODE 
Sornoees :WAVeform:YINCrement? 
:WAVeform:YREFerence? 
:WAVeform:YORigin? 
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:WAVeform:XINCrement? 
Syntax :WAVeform:XINCrement? 


Description Query the time difference between two neighboring points of the specified channel source 
in the X direction. 


Explanation > 


The returned value is related to the current data reading mode: 

In the NORMal mode, XINCrement = TimeScale/100. 

In the RAW mode, XINCrement = 1/SampleRate. 

In MAX mode, XINCrement = TimeScale/100 when the instrument is in running 
status; XINCrement = 1/SampleRate when the instrument is in stop status. 


The unit is related to the current channel source: 

When the channel source is one from CHANneli to CHANnel4 or from DO to D1i5, the 
unit is s. When the channel source is MATH and the operation type is FFT, the unit is 
Hz. 


Return The query returns the XINCrement in scientific notation. 


Format 


Example :WAVeform:XINCrement?  /*The query returns 1.000000e-08*/ 
Related :WAVeform:SOURce 


Command 


:WAVeform:XORigin? 
Syntax :WAVeform:XORigin? 


Description Query the start time of the waveform data of the channel source currently selected in the 
X direction. 


Explanation > 


The return value is related to the current data reading mode: 

In NORMal mode, the query returns the start time of the waveform data displayed on 
the screen. 

In RAW mode, the query returns the start time of the waveform data in the internal 
memory. 

In MAX mode, the query returns the start time of the waveform data displayed on the 
screen when the instrument is in running status; the query returns the start time of 
the waveform data in the internal memory when the instrument is in stop status. 


The unit is related to the current channel source: 

When the channel source is one from CHANneli to CHANnel4 or from DO to D1i5, the 
unit is s. 

When the channel source is MATH and the operation type is FFT, the unit is Hz. 


Return The query returns the XORigin in scientific notation. 


Format 


Example :WAVeform:XORigin? /*The query returns -6.000000e-06*/ 
Related :WAVeform:SOURce 


Commands 


:WAVeform:XREFerence? 
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:WAVeform:XREFerence? 


Syntax 
Description 


Return 
Format 


Related 
Command 


:WAVeform:XREFerence? 
Query the reference time of the specified channel source in the X direction. 


The query returns 0 (namely the first point on the screen or in the internal memory). 


:WAVeform:SOURce 


:WAVeform:YINCrement? 


Syntax 


Description 


Explanation 


Return 
Format 


Example 


Related 
Command 


:WAVeform:YINCrement? 


Query the waveform increment of the specified channel source in the Y direction. The unit 
is the same as the current amplitude unit. 


The return value is related to the current data reading mode: 

In NORMal mode, YINCrement = VerticalScale/25. 

In RAW mode, YINCrement is related to the Verticalscale of the internal waveform and the 
Verticalscale currently selected. 

In MAX mode, YINCrement = VerticalScale/25 when the instrument is in running status; 
YINCrement is related to the Verticalscale of the internal waveform and the Verticalscale 
currently selected when the instrument is in stop status. 


The query returns the YINCrement in scientific notation. 


:WAVeform:YINCrement? 
:WAVeform:SOURce 


/*The query returns 8.000000e-03*/ 


:WAVeform:YORigin? 


Syntax 


Description 


Explanation 


Return 
Format 


Example 


Related 
Commands 


:WAVeform:YORigin? 


Query the vertical offset relative to the vertical reference position of the specified channel 
source in the Y direction. 


The return value is related to the current data reading mode: 

In NORMal mode, YORigin = VerticalOffset/YINCrement. 

In RAW mode, YORigin is related to the Verticalscale of the internal waveform and the 
Verticalscale currently selected. 

In MAX mode, YORigin = VerticalOffset/YINCrement when the instrument is in running 
status; YORigin is related to the Verticalscale of the internal waveform and the 
Verticalscale currently selected when the instrument is in stop status. 


The query returns an integer. 


:WAVeform:YORigin? 
:WAVeform:SOURce 
:WAVeform:YREFerence? 


/*The query returns 25*/ 
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:WAVeform:YREFerence? 


Syntax 
Description 


Explanation 


Return 
Format 


Related 
Command 


:WAVeform:YREFerence? 
Query the vertical reference position of the specified channel source in the Y direction. 


The return value is related to the current data reading mode: 

In NORMal mode, YREFerence is always 127 (the screen bottom is 0 and the screen top is 
255). 

In RAW mode, YREFerence is related to the Verticalscale of the internal waveform and the 
Verticalscale currently selected. 

In MAX mode, YREFerence is always 127 (the screen bottom is 0 and the screen top is 
255) when the instrument is in running status; YREFerence is related to the Verticalscale 
of the internal waveform and the Verticalscale currently selected when the instrument is in 
stop status. 


The query returns an integer. 


:WAVeform:SOURce 


:WAVeform:STARt 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


Related 
Commands 


:WAVeform:STARt <sta> 
:WAVeform:STARt? 


Set or query the start point of waveform data reading. 


Type 


Name Range Default 


NORMal: 1 to 1200 

MAX: 1 to the number of effective points 
currently on the screen 

RAW: 1 to the current maximum memory depth 


<sta> Integer 


When reading the waveform data in the internal memory, the actual settable ranges of the 
start point and stop point of a reading operation are related to the memory depth of the 
oscilloscope and the return format of the waveform data currently selected; for the 
details, refer to the explanation in the :WAVeform:DATA? command. 


The query returns an integer. 


:WAVeform:STARt 100 
:WAVeform:STARt? 


:ACQuire:MDEPth 
:WAVeform:MODE 
:WAVeform:FORMat 
:WAVeform:STOP 


/*Set the start point to 100*/ 
/*The query returns 100*/ 
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:WAVeform:STOP 


Syntax 


Description 


Parameter 


Explanation 


Return 
Format 


Example 


Related 
Commands 


:WAVeform:STOP <stop> 
:WAVeform:STOP? 


Set or query the stop point of waveform data reading. 


Name Type Range Default 


NORMal: 1 to 1200 

MAX: 1 to the number of effective point 
currently on the screen 

RAW: 1 to the current maximum memory depth 


<stop> Integer 1200 


When reading the waveform data in the internal memory, the actual settable ranges of the 
start point and stop point of a reading operation are related to the memory depth of the 
oscilloscope and the return format of the waveform data currently selected; for the 
details, refer to the explanation in the :WAVeform:DATA? command. 


The query returns an integer. 


:WAVeform:STOP 500 /*Set the stop point to 500*/ 
:WAVeform:STOP? /*The query returns 500*/ 


:ACQuire:MDEPth 
:WAVeform:MODE 
:WAVeform:FORMat 
:WAVeform:STARt 
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:WAVeform:PREamble? 


Syntax 
Description 


Return 
Format 


Example 


Related 
Commands 


:WAVeform:PREamble? 
Query and return all the waveform parameters. 
The query returns 10 waveform parameters separated by ",": 


<format>,<type>,<points>,<count>,<xincrement>,<xorigin>,<xreference>,<yincrem 
ent>,<yorigin>,<yreference> 


Wherein, 

<format>: 0 (BYTE), 1 (WORD) or 2 (ASC). 

<type>: 0 (NORMal), 1 (MAXimum) or 2 (RAW). 

<points>: an integer between 1 and 24000000. 

<count>: the number of averages in the average sample mode and 1 in other modes. 
<xincrement>: the time difference between two neighboring points in the X direction. 
<xorigin>: the start time of the waveform data in the X direction. 

<xreference>: the reference time of the data point in the X direction. 

<yincrement>: the waveform increment in the Y direction. 

<yorigin>: the vertical offset relative to the "Vertical Reference Position" in the Y 
direction. 

<yreference>: the vertical reference position in the Y direction. 


:WAVeform:PREamble? /*The query returns 


0,2,6000000, 1, 1.000000e-09, -3.000000e-03,0,4.132813e-0 
1,0,122*/ 


:WAVeform:FORMat 


:WAVeform:MODE 


:ACQuire:AVERages 


:WAVeform:XINCrement? 
:WAVeform:XREFerence? 


:WAVeform:YINCrement? 


:WAVeform:YORigin? 


:WAVeform:YREFerence? 
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Chapter 3 Programming Demos 


This chapter lists some programming demos to illustrate how to use commands to realize the common 
functions of the oscilloscope in the development environments of Excel, Matlab, LabVIEW, Visual Basic 6.0 
and Visual C++ 6.0. All the demos are based on VISA (Virtual Instrument Software Architecture). 

The main topics of this chapter: 

Programming Preparations 

Excel Programming Demo 

Matlab Programming Demo 


LabVIEW Programming Demo 


Visual Basic Programming Demo 
Visual C++ Programming Demo 
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Programming Preparations 


Before programming, you need to make the following preparations: 


First, install the Ultra Sigma common PC software. You can log in RIGOL official website (www.rigol.com) 
to download the software; then, install the software according to the instructions. When Ultra Sigma is 
installed, the NI-VISA library is installed automatically. Here, the default installation path is C:\Program 
Files\IVI Foundation\VISA. 


Here, the USB interface of the oscilloscope is used to communicate with the PC and please use a USB cable 
to connect the USB Device interface at the rear panel of the oscilloscope to the PC. After successful 
connection, power on and start the instrument (make sure that Utility, > IO Setting > USB Device is 
currently set to "Computer"). At this point, the "Found New Hardware Wizard" dialog box appears on 
the PC at the first connection. Please follow the instructions to install the "USB Test and Measurement 
Device (IVI)". 


Found New Hardware Wizard 


This wizard helps you install software for: 


USB Test and Measurement Device (TVI) 


c ) If your hardware came with an installation CD 
<6 or floppy disk, insert it now. 


What do you want the wizard to do? 


© Install the software automatically (Recommended) 
©@) Install from a list or specific location (Advanced) 


Click Next to continue. 


By now, the programming preparations are finished. In the following part, detailed introductions are given 
about the programming demos in the Excel, Matlab, Labview, Visual Basic 6.0, and Visual C++ 6.0 
development environments. 
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Excel Programming Demo 


The program used in this demo: Microsoft Excel 2010 


RIGOL 


The function realized in this demo: send the *IDN? Command to read the device information. 


1. Create a new Excel file that enables the Macros. In this demo, the file is named as IDN.xlsm. 


2. Run the IDN.xlsm file. Click File>Options at the upper-left corner of the Excel file to open the 
interface as shown in the figure below. Click Customize Ribbon at the right, check Developer and 
click OK. At this point, the Excel menu bar displays the Developer menu. 


Excel Options 


General 


Formulas 


Choose commands from: ( 


Proofing Popular Commands 


Save 

lly All Chart Types... 
Borders 

Advanced Calculate Now 


Quick Access Toolbar 


Language 


Connections 
Copy 
Custom Sort... 


Add-Ins Cut 


| Customize the Ribbon. 


Conditional Formatting 


Trust Center 


Decrease Font Size 
Delete Cells... 

Delete Sheet Columns 
Delete Sheet Rows 


E-mail 

Fill Color 
Filter 

Font 

Font Color 
Font Size 
Format Cells... 
Format Painter 
Freeze Panes 


Hi 
a 
(¢3 
& 
« 
3x 
# 
a 
ga 
2 
Y= 


Insert Cells... 
Insert Function... 


Py Ea > 


c 
c 


Macros 
Merge & Center 
Name Manager 


‘olatét a UM 


Increase Font Size 


Insert Sheet Columns 
Insert Sheet Rows 


Customize the Ribbon:( 
Main Tabs 


KS] KS] KS] KSI KS ESSE) 


QHAARAAAA 


-) 
a 
c 
“ 


Home 
Insert 

Page Layout 
Formulas 
Data 
Review 
View 

M Developer 
+] Code 

+) Add-Ins 
+] Controls 
+] XML 


+] Modify 

[¥] Add-Ins lated 
[¥] Acrobat ca 
[¥] Background Removal 


Customizations: (Reset > |< 


Import/Export ¥ |\ 
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3. Enter the VISA descriptor into a cell of the file as shown in the figure below. For example, the VISA 
descriptor is USBO::0x1AB1::0x04CE::DS1ZA160801111::INSTR. Input it into SHEET1.CELLS(1,2) 
(namely the Bi cell in Sheet1). Click the Developer menu and select the Visual Basic option to open 
the Microsoft Visual Basic. 


(x] IDN.xlsm - Microsoft Excel 
Home Insert Page Layout Formulas Data Review View Developer Acrobat 
: “cy | = = General : f) Conditional Formatting * 
‘eB & Times New Roman “18; “A «A = be _ . ing 
Ear = faj~ GB~ % » [Be Format as Table ~ 
Paste + | His | Qe + | tee] . ss 
s gf Biu Hy | Oa A A”) a y 59:08 5} cell Styles ~ 
Clipboard %& . Alignment % Number ry Styles 


(x) IDN.xlsm - Microsoft Excel 


Home Insert Page Layout Formulas Data Review View Developer Acrobat 


= [JRecord Macro & E— Se * (FP Properties [=a Sf Map Properties [din 
= Use Relative References —_ view Code | pa Expansion Packs @r) E> 
Macros Add-Ins COM Insert Desigr Source .... wat 

A Macro Security Add-Ins - Mode ‘@ Run Dialog "> 


sae 


Code Add-Ins Controls XML 


4. Select Tools(T) in the Microsoft Visual Basic menu bar and click References. 
? File Edit View Insert Format Debug Run | Tools Add-Ins Window Help 


: 
BGG kana oc. 
pike he SP ee x Additional Controls... lo 


Select VISA Library in the pop-up dialog box and click OK to refer to the VISA Library. 
References — ¥BAProject 


Available References: 


™ Visual Basic For Applications Cancel 


Microsoft Excel 14.0 Object Library aed _| 


OLE Automation 


| Microsoft Office 14.0 Object Librar Browse... 
vi sr ier 


O 145 Helper COM Component 1.0 Type Library +| 
_| T4S RADIUS Protocol 1.0 Type Library 


| Acrobat Priority 
_| Acrobat Access 3.0 Type Library Help | 


_| Acrobat Distiller + | 
_| Acrobat Scan 1.0 Type Library 


__| Acrobat WebCapture 1.0 Type Library 
_| Acrobat 'WebCapture IE Toolbar/Favorites 1.0 Type | 
[| ArraRrokerl ih be) 


< il > 


v 


VISA Library 


Location:  C:\WINDOWS\system32\visa32.dll 
Language: Standard 
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Explanation: 


If you cannot find the VISA Library in the list at the left of the figure above, please follow the 

method below to find it. 

(1) Make sure that your PC has installed the NI-VISA library. 

(2) Click Browse... at the right and set the search range to C:\WINDOWS\system32 and the 
filename to visa32.dll, as shown in the figure below. 


Add Reference 


Look in: | C2) system32 ~| = © ck Eee 


{)3com_dmi (1041 
(1025 (1042 
(1028 (1054 
(1031 (2052 
(1033 (3076 
(1037 (Daliedit 


4)\\]| >| 
File name: visa32. d11| 


Files of type: | Type Libraries (*.olb;*.tIb;* dll) Re | Cancel | 
Help | 


5. Click View Code in the Developer menu to enter the Microsoft Visual Basic interface. Add the 
following codes and save the file. 


Note: If the Excel file created at step 2 does not enable the Macros, at this point, the prompt message 
"The following features cannot be saved in macro-free workbooks" will be displayed. In this situation, 
please save the Excel file as a file using the Macros (the filename suffix changes to .xlsm). 


Sub QueryIdn() 


Dim viDefRm As Long 

Dim viDevice As Long 

Dim viErr As Long 

Dim cmdsStr As String 

Dim idnStr As String * 128 
Dim ret As Long 


‘Turn on the device, the device resource descriptor is in CELLS(1,2) of SHEET1’ 
viErr = visa. viOpenDefaultRM(viDefRm) 
viErr = visa.viOpen(viDefRm, Sheet1.Cells(1, 2), 0, 5000, viDevice) 


‘Send request, read the data, the return value is in CELLS(2,2) of SHEET1’ 
cmdStr = "*IDN?" 

viErr = visa.viWrite(viDevice, cmdStr, Len(cmdStr), ret) 

viErr = visa.viRead(viDevice, idnStr, 128, ret) 

Sheet1.Cells(2, 2) = idnStr 


‘Turn off the device’ 
visa.viClose (viDevice) 
visa.viClose (viDefRm) 


End Sub 
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6. Add button control: click Insert in the Developer menu, select the desired button in Form Controls 
and put it into the cell of the Excel. At this point, the Assign Macro interface is displayed, select 
"Sheet1.QuerylIdn" and click "Run". 


Macro name: 


Sheetl. QueryIdn 


id » 2 (Sf Properties 


C2! View Code 


Design 
Mode ‘@ Run Dialog 


| Form Controls |S Macros in: | All Open Workbooks 
as vi al EE © Description — 
= [| Aa s ab] [5 EB 
y¢ Activex Controls 
a 8M CoB 2 
BqOAMFR 


By default, the button mane is "Button 1". Right-click the button and select Edit Text in the pop-up 
menu to change the button name to "*IDN?". 


7. Click the "*IDN?" button to send request and read data. The returned data will be displayed in SHEET1 
CELLS (2,2). 
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Matlab Programming Demo 


The program used in this demo: MATLAB R2009a 


The function realized in this demo: make FFT operation on the waveform data and draw the 
waveform. 


1. 


Run the Matlab software and modify the current directory (namely modify the Current Directory at 
the top of the software). In this demo, the current directory is modified to E:\MSO1000Z_ Demo. 


MATLAB 7.8.0 (R2009a) 
File Edit Debug Parallel Desktop Window Help 


-06\ 4 SB @ | See 2) | © |e: \s010002_Deno viCj 8 


Click File > New > Blank M-File in the Matlab interface to create an empty M file. 
Add the following codes in the M file: 


% Create VISA object 
MSO1000Z = visa(‘ni'’,'USBO::0x1AB1::0x04CE::DS1ZA160801111::INSTR’); 


% Set the device property. In this demo, the length of the input buffer is set to 2048. 
MSO1000Z.InputBufferSize = 2048; 


% Open the VISA object created 
fopen(MSO1000Z); 


% Read the waveform data 
fprintf(MSO1000Z, ':wav:data?' ); 


% Request the data 
[data,len]= fread(MSO1000Z,2048); 


% Close the VISA object 
fclose(MSO1000Z); 
delete(MSO1000Z); 
clear MSO1000Z; 


% Data processing. The waveform data read contains the TMC header. The length of the header is 11 
bytes, wherein, the first 2 bytes are the TMC header denoter (#) and the width descriptor (9) 
respectively, the 9 bytes following are the length of the data which is followed by the waveform data 
and the last byte is the terminator (Ox0A). Therefore, the effective waveform points read is from the 
12nd to the next to last. 

wave = data(12:len-1); 

wave = wave’; 

subplot(211); 

plot(wave); 

fftSpec = fft(wave',2048); 

fftRms = abs(fftSpec'); 

fftLg = 20*log(fftRms); 

subplot(212); 

plot(fftLg); 


Save the M file under the current directory. In this demo, the M file is named as 
MSO1000Z_Demo_MATLAB.m. 
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5. Run the M file and the running result is as follows. 


Figure 1 Cel) 
File Edit View Insert Tools Desktop findow Help 
QDGaS/F|ASAC90LK-|\2\0H8\/ao 
(i) Note new toolbar buttons: data brushing & linked plots 4 a Play video 

200 


1 n 
800 1000 
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LabVIEW Programming Demo 

The program used in this demo: LabVIEW 2009 

The functions realized in this demo: read the waveform data of CH1 on the screen. 
1. Run LabVIEW 2009, create a VI file and name it as MSO1000Z_Demo. 


2. Add controls. Right-click in the Front Panel interface, select and add VISA resource name and 
Waveform Graph from the Controls column, as shown in the figures below. 


Ee) Controls Q search| 

Modern , 

System » 

Express * 44 Classic 

$ » >| Ona” Classic L/0 
pt = 
yma : 
ea 4a) o,'! 
are eae » » Lb | [Slate] 
4 9 aoe EA » > 
aan 

Control Design & Simulation } Fllza) “fe Ea] 

NET & Activex (Cy ( 

Signal Processing » Aevonel) 2) A $5 ctessie 1/0 

Addons ' FA) \ 

User Controls , [or] i] 
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3. Open the Block Diagram interface. Right-click on the VISA resource name and you can select and 
add the following functions from VISA Palette from the pop-up menu: VISA Write, VISA Read, 
VISA Open, and VISA Close. 

VISA resource name 
vIsAl fi 
nee Visible Items 7 
Find Control 
Hide Control 
Change to Indicator 
Change to Constant 
Description and Tip... 
Create Visa | [lisa 
pt | tc 
Data Operations : oa Rey Pen au 
VISA sre VISA VISA 
SSIESI8, SoCs 
Select VISA Class p | eH leo EEN Lee SES = ZI \E : 
oH 
I/O Name Filtering... iat tol 
Jf View As Icon | EM + : 
R Eu Event 
Properties a ea 
a eae 

4. Connect the VISA resource name with the VISA Open. Then, connect the VISA resource name 
outputs of all the functions with the VISA resource name and connect the error output with the 
error input as shown in the figure below. 

VISA resource name 

5. Add text boxes in the write buffer areas of the VISA Write control and input ":WAV:SOUR CHAN1", 
":!WAV:FORM BYTE", and ":WAV:DATA?" respectively. The first sets the channel source to CH1, the 
second sets the waveform reading format to BYTE and the last reads the screen waveform data. 
Waveform data is read through the VISA Read function which requires users to input the total 
number of bytes to be read. In this example, the total number of bytes of waveform data to be read is 
less than 2048. Close the VISA resource after the VISA operation is finished. 

VISA resource name 

6. The data format is TMC header + waveform data points + terminator. The TMC header is in #NXXXXXX 
format, wherein, # is the TMC header denoter, N represents that there are N bytes following. The 
length of the waveform data points is described in ASCII character, and the terminator represents the 
ending of the communication. For example, for #9000001200XXxXxX, 9 bytes are used to describe the 
length of the data, 000001200 represents the length of the waveform data (namely 1200 bytes). Use 
the String Subset and Decimal String To Number functions to get the value of N. 
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HOOOODOOOOOOOD 


offset past number 


string Eo string 
offset (0) offset 
length (rest) “ number 


DOOORBOBOOOOBBOOOD 


7. Convert the character data into array format using the String To Byte Array, namely display the 
waveform data on the Waveform Graph control and then remove the TMC data header using the 


Array Subset function. 


wav: DATA?} [2098 


{wisi wisi {wii} 
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9. Select the device resource from the VISA Resource Name list box and run the program. 


& NS01000Z Demo. vi Front Panel 


File Edit View Project Operate Tools Window Help 


i) &| @ [a1] 12pt Application Font |¥ |[2o~|[-ta~|[-] [65~] 
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Visual Basic Programming Demo 

The program used in this demo: Visual Basic 6.0 

The function realized in this demo: control the on/off state of any channel. 

Enter Visual Basic 6.0 and operate according to the following steps: 

1. Build a standard application program project (Standard EXE) and name it as Demo. 

2. Click the Existing tab of Project>Add Module. Search for the visa32.bas file in the include folder 


under the NI-VISA installation path and add the file. 
Add Hodule 


New Existing 


Look in: | (© include 


AS vpptype bas 


File name: visad2. bas Open (0) 
Files of type: Basic Files (*. bas) bd | 


Cancel 


Help Q) | 


. Don’t show this dialog in the future 


3. Add four CommandButton controls to represent CH1 to CH4 respectively. Add four Label controls 
(Label1(0), Label1(1), Label1(2), and Label1(3)) to represent the status of CH1 to CH4 respectively 
(when the channel is enabled, it displays the color of the channel; when the channel is disabled, it 
displays gray). The layout of the controls is as shown in the figure below. 


4. Open the General tab in Project>Projecti1 Properties and select Form1 in the Startup Object 
dropdown box. 


5. Double-click CH1 to enter the programming environment. Add the following codes to control CH1 to 
CH4. The codes of CH1 are as shown below; the codes of other channels are similar. 


Dim defrm As Long 

Dim vi As Long 

Dim strRes As String * 200 
Dim list As Long 

Dim nmatches As Long 
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Dim matches As String * 200 ' keep the device number acquired 
Dim s32Disp As Integer 

"acquire the usb source of visa 

Call viOpenDefaultRM(defrm) 

Call viFindRsrc(defrm, "USB?*", list, nmatches, matches) 
"Open the device 

Call viOpen(defrm, matches, 0, 0, vi) 

"Send the command to query the status of CH1 
Call viVPrintf(vi, ":CHAN1:DISP?" + Chr$(10), 0) 
" Acquire the status of CH1 

Call viVScanf(vi, "Yt", strRes) 

s32Disp = CInt(strRes) 

If (S32Disp = 1) Then 

"Send the setting command 

Call viVPrintf(vi, ":CHAN1:DISP 0" + Chr$(10), 0) 
Labeli(0).ForeColor = &H808080 ‘Gray 

Else 

Call viVPrintf(vi, ":CHAN1:DISP 1" + Chr$(10), 0) 
Label1(0).ForeColor = &HFFFF& ‘Yellow 

End If 

"Close the device 

Call viClose(vi) 

Call viClose(defrm) 


Chapter 3 Programming Demos 


Save and run the project and a single exe program will be obtained. When the oscilloscope is correctly 


connected to the PC, the ON/OFF control of any channel can be 


realized. 
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Visual C++ Programming Demo 
The program used in this demo: Microsoft Visual C++ 6.0 


The functions realized in this demo: search for the instrument address, connect the instrument, send 
command and read the return value. 


Enter Visual C++6.0 and operate according to the following steps: 
1. Create a MFC project based on dialog box. 


2. Open the C/C++ tab in Project Settings, select Code Generation in Category and Debug 
Multithreaded DLL in Use run-time library. Then, click OK to close the dialog box. 


Settings For: \Win32 Debug =|} General | Debug CiCee | Link | Resources | M 


: 
ategory: |Code Generation , Reset | 


Processor: 
[Blend * 


Calling comvention: Struct member alignment: 
|__edect * +) [8 Bytes* 7 


Project Options: 


Jnologo IMDd AYV3 (Gm [GX /21 fod 1D “"WIN32" /D 
™ DEBUG" (0 " WINDOWS" /D"_APXDLL" /D"_MBCS" 
iF "DebugidemolDN.pe" fu" stdab.n" fFo"Debugf* 


3. Open the Link tab in Project>Settings and add visa32.lib to the Object/library modules 
manually. 


Settings For: \Win3? Debug +) | General | Debug | CyC++ Link | Resources | M 


cotcgory: TT =| Bese 


Output file name: 
[Debug/demolDN.exe 


ObjecYlibrary modules: 
sad2tib 


™ Generate debug into © Ignore all detault libraries 
Link incrementally Generate mapfile 
Enable profiling 


Project Options: 


Visa32.tib fs tnologo Tsubsystem:windows 
Jincrementalyes Ipdb:"DebugidemolDN.pdb” idebug 
machine: 1386 fout""Debug/demolDN,exe" 
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4. Open the Directories tab in Tools>Options. 
Select Include files in Show directories for and double-click the blank in Directories to add the 
path of Include: C:\Program Files\IVI Foundation\VISA\WinNT\include. 

Select Library files in Show directories for and double-click the blank in Directories to add the 
path of Lib: C:\Program Files\IVI Foundation\VISA\WinNT\lib\msc. 


Options 


Editor | Tabs | Debug | Compatibility | Build Directories | Works) 


Platform: Show directories for: 
Win32 ’ Include files 
Directories: 


D-AProqram Files\Microsoft Visual Studio\VC98\INCLUDE 
D:\Program Files\Microsoft Visual Studio\VC98\MFC\NCLUDE 
‘\Proqram Files\Microsoft Visual Studio\VC9SB\ATLIINCLUDE 


Note: at present, VISA library has been added. 


5. Add the Text, Combo Box, Button and Edit Box controls as shown in the figure below. 
ME demoIDN 


6. Modify the control attribute. 
1) Name Text as "Command". 
2) Open the Data item in Combo Box attribute and input *IDN? Manually. 
3) Open the General item in Edit Box attribute and select Disabled. 
4) Name Button as Send and Read. 
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7. Add the variables m_combox and m_receive for the Combo Box and Edit controls respectively. 
MB denoIDH 


Bd Copy 
Fr ; 


Insert ActiveX Control... 


vd Check Mnemonics 


[Serer 


Events... 


eS Properties 


Nemessconsscsmnessomnsssomesscomscscamessommsssomacscomsssoomesseemesss 


Message Maps Member Variables | Automation | ActiveX Events | Class Info | 


Project. Class name: Add Class... * | 
demolDN 2 [CDemolDNDIg - 

Add Variable... 
E:...\demolIDNWemolDNDig.h, E:...\demolIDN\demolDNDIg.cpp 


type Member Delete Variable | 


Description: CString with length validation 


Maximum Characters: 


8. Add codes. 
Double-click Send and Read to enter the programming environment. Declare the #include 
<visa.h> of the visa library in the header file and then add the following codes. 


ViSession defaultRM, vi; 
char buf [256] = {0}; 
CString s,strTemp; 
char* stringTemp; 


ViChar buffer [VI_FIND_BUFLEN]; 
ViRsrc matches=buffer; 

ViUInt32 nmatches; 

ViFindList list; 


viOpenDefaultRM (&defaultRM); 
//Acquire the USB resource of visa 
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viFindRsrc(defaultRM, "USB?*", &list,&nmatches, matches); 
viOpen (defaultRM,matches,VI_NULL,VI_NULL,&vi); 


// Send the command received 
m_combox.GetLBText(m_combox.GetCurSel(),strTemp); 
strTemp = strTemp + "\n"; 

stringTemp = (char*)(LPCTSTR)strTemp; 

viPrintf (vi,stringTemp); 


// Read the result 
viScanf (vi, "Yot\n", &buf); 


// Display the result 
UpdateData (TRUE); 
m_receive = buf; 
UpdateData (FALSE); 
viClose (vi); 

viClose (defaultRM); 
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9. Save, compile and run the project and a single exe file can be obtained. When the oscilloscope is 
correctly connected to the PC, you can select the command *IDN? and click Send and Read to 
display the return result of the oscilloscope. 
> demoIDH 

a 
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